Call for Documentation!
Christoph Hart last edited by
I spent the last days on writing a system that embeds the documentation into HISE. The system is using a subset of Markdown for formatting (I had to write a dedicated Markdown Parser for this).
The beauty of this is that there is finally a way of contributing to the development of HISE for people who can't write C++ code - which to be honest is the sole reason why people are using HISE
There are three things that can be done:
1. Help Buttons
There is now a small button that can be placed anywhere in HISE that pops up a help page explaining things. So if you think there is something not self-explanatory (like the Filename-Parser or the funky Wavetable Conversion Dialogue), just write up a documentation in Markdown, post it here and I'll add it to the codebase:
While embedding real images is not yet supported, the Markdown parser can display icons. So if you eg. create a documentation for a menubar, just write up dummy links and I'll replace them with the proper icons
2. Extended API documentation
The Scripting API documentation can now be extended to a more comprehensive description including code snippets:
If you want to contribute to the API documentation, you'll need to use a meta-formatting markup syntax, that I've explained here:
3. Module Documentation
Every module in HISE will be documented with a list of all parameters and modulation possibilities (a bit like the abandoned module page on the current HISE docs). I'll need to tidy this up, but then I'll come up with a system similar to the Scripting API Documentation.
That's it. From now on I try to keep adding the documentation one thing after another, so the more people contribute, the faster we'll have a complete documentation. If you don't want to write things yourself, you can also just come up with a suggestion what is missing the most (eg. a certain API method that you never understood), which will help me (or other contributors) prioritize what should be documented next.
BTW, I have plans to add this system to compiled plugins too, so you can easily create help popups in your project too using Markdown and a dedicated FloatingTile.
d.healey last edited by
Excellent, looks very useful!
remarkablex last edited by
Great! Very helpful, especially for beginners....
jadg last edited by
Wonder. l I Hope I can use It many times. Thanks
chris last edited by
dustbro last edited by
sick! very helpful