Home

Welcome to the Ciera project!

• The User Guide (or the online PDF) is a good place to start to see examples and learn more about how to use Ciera.

• Found a bug? See the Issue tracker.

• The Engineering Documentation has more technical topics about the development of the project.

• See the latest runtime API docs.

Contribution Guidelines

If you would like to contribute to either the documentation (wiki) or the source repository, please follow these guidelines.

Create an issue

Always start by creating an inssue in the Issue Tracker. Be sure to include details about what the expected and observed behavior is (in the case of a bug), and if possible attach a reproduction case or give detailed instructions on how to reproduce. If the issue is a feature, describe exactly what the proposed requirements are.

Implementation

During implementation of a feature or bug fix, make all commits in a branch in your fork of the repository. Each commit message should begin with job #<issue_number> so that all changes can be tracked.

Documentation/Review

For small bug fixes, conversation in the issue tracker is sufficient. However, for more extensive changes and features, an engineering note should be created.

To create a new engineering note:

• Fork the xtuml/cieradoc repository.

• In the doc/ subdirectory, duplicate and rename template.asciidoc to "<issue_number>_<title>.asciidoc"

• Fill out the template with relevant information and commit the changes.

• Submit a PR to the "xtuml/cieradoc" repository for review.

Helpful page regarding AsciiDoc: (AsciiDoc quick reference).

Submitting a pull request

When your feature and documentation are complete, submit a pull request to the Ciera source repository. Be sure to include a link to the issue and the engineering note in the pull request. From there a committer will work with you to review and merge the change into master.

Contributing to the user guide

To contribute to the user guide, simply edit pages in this wiki. Please tag all changes with a corresponding issue in your commit message. Discussion of changes to the user guide should occur in the issue before any changes are made.

How to build and distribute the user guide

1. Clone the repository.

   git clone https://github.com/xtuml/ciera.wiki
   cd ciera.wiki

2. Make sure the version is up to date. Edit line 3 of Guide.asciidoc, the version in pom.xml and find and replace all references to the latest version ID in the guide itself.

3. Build the PDF user guide

   mvn clean process-resources

4. Copy the user guide to the userguide/en_US directory of the cieradoc repository. Commit and push.

   cp target/generated-docs/CieraUserGuide.pdf ~/git/cieradoc/userguide/en_US