-
Notifications
You must be signed in to change notification settings - Fork 26
Documenting an Example
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.