Page 1 of 1
Incomplete Component Reference
Posted: Mon Dec 03, 2012 7:06 pm
by mark202
Hello,
I have just purchased and started using FS. Some of the components (example: display window) do not have any reference in the Component Reference manual. Is there another source for this info?
Thanks,
Mark
Re: Incomplete Component Reference
Posted: Tue Dec 04, 2012 10:41 am
by support
Yes, if you hover the mouse over the component it gives you a description.
Here's an example:

- Display Window clip.png (68.68 KiB) Viewed 13114 times
Please note that the component reference is not for modules (i.e components are the base FlowStone building blocks and modules are made using components).
Re: Incomplete Component Reference
Posted: Tue Dec 04, 2012 8:14 pm
by trogluddite
As a little side note, I'd just like to add this...
If you are posting your own modules on the forum, please try and take the small amount of extra time to do a little 'built in documentation', like admin's example, yourself.
It really isn't difficult, and will possibly help you out too if you ever need to fix a bug or add a new feature. The things I would recommend are...
- Please give your modules, and any value boxes etc. a meaningful title.
- Be sure to label all of your inputs and outputs - including on sub-modules inside your main block.
- Use the 'comment' module to add notes within the modules about any particularly unusual features (they are set to be 'purgable' so they won't take up any space inside your final exports)
- Add a 'tooltip help' primitive to the top level module, connect a text box, and type in a short description of what your module does, any important notes about the correct number ranges etc. for inputs and outputs, and a little note saying who you are, credits for anyone who helped you, and any 'licence restrictions' you want people that use your module to observe (a version number can also be useful, in case you ever need to post an upgrade).
The tooltip help is particularly useful. As well as enabling the cool little 'hover over' tooltips, the text inside gets read when you use the toolbox search feature - so if folks like your module enough to put it in their toolbox, it will be easy for them to find!
Re: Incomplete Component Reference
Posted: Wed Dec 05, 2012 4:17 am
by mark202
Thank you both for your responses.
The "Components Manual" being for components was overlooked by me. Read
the manual but not the title.
Thanks again,
Mark