Add your sample to the docs
To document a sample bundle take a look at the name of the service the sample
bundle is for. If it's for example nodecg-io-example
the documentation should
go into docs/samples/example.md
in the doc's repository. There you should
include a step-by-step manual how to configure the service and get the bundle
running.
Attention
Don't forget to add the newly created Markdown file to mkdocs.yml
.
Note
When you create your documentation pull request, please include the ID of your PR in the main repository in the description, so the documentation will not be merged before the actual code.
You should make this very detailed, so everyone gets it to work because a super-good implementation is worth nothing if there's nobody who can use it. Take a look at the twitch sample bundle.
Note
We also have the getting started section and especally the "Try an included sample"-Guide, so you can offload some of the documentation to stuff aready written there.
Guidelines
[…] The sample docs should […] be centered around the service and not the sample […]. Writing what the sample does with the service and how it is named should be enough.
Actually the ChatOverflow docs are a good example […].
Have a guide how to use the dashboard and then an entry for each service that describes what config it needs and where you can get tokens. Instead of a code snipped I would then explain what the sample does and link to it.~ (daniel0611 27.02.2021 on GitHub) shortened by the author