Skip to content

Documenting an Example

Rene Beckmann edited this page Jul 12, 2016 · 4 revisions

You created a useful example and think others might be interested in it. Also, you have forked the example repository, cloned it, and added your project. Good! Now it's time to document what you have done.

Go to the forked repository's directory. You will find a folder named example_template. Copy its contents into your project.

This should contain the following files:

  • /images
  • .gitignore
  • index.html
  • metadata.json_deactivated

The index.html is the place where you document your project. Open it in an editor of your choice - it should turn out to be basically self-explanatory. Your example's title needs to go in two places, which are marked in the html file - the <title>-tag and the <h1>-tag. You are not meant to use more <h1> tags, please only use headings one level lower. Your title should be crisp and unique inside of the Example-repository. It's the one that's displayed in the Example wizard and should tell people what they can expect from your example.

Below, you can write some stuff about your project, whatever you want. Make sure to use the given template for images. Put your images into the images folder. You should at least have a screenshot of your statechart (which can be created with YAKINDU SCT itself, just right click in your statechart). You can of course use more images, like detailed parts. Especially when you use YAKINDU SCT to create software that runs on embedded hardware, a photo of your setup would be nice. If it suits your needs, you are allowed to link to a video on Youtube in your index.html. Other streaming platforms are not allowed.

The next step will be to write the neccessary metadata for the example, then you are ready to publish.