Complete Documentation
Posted: Sat Jul 22, 2017 2:59 pm
Please. Please, please, please. Pretty please. Spend some time on documentation. What I've read so far just scratches the surface and explains brewing itself and not the software. It's almost as if the person that wrote the documentation is not the developer and doesn't understand the software and just wrote some basic brewing knowledge down.
Examples of where this would be really helpful:
- How the heck the parameters set in one spot affect calculated parameters in other spots
- Contextual tips that explain why a value isn't editable and what is affecting it
A more concrete example:
- Schedule stage definition (you've already covered what mashing in is... now tell me how to calculate the temperature of my strike water because that form is NOT self explanatory given what I've found tooling around the software without real documentation)
Examples of where this would be really helpful:
- How the heck the parameters set in one spot affect calculated parameters in other spots
- Contextual tips that explain why a value isn't editable and what is affecting it
A more concrete example:
- Schedule stage definition (you've already covered what mashing in is... now tell me how to calculate the temperature of my strike water because that form is NOT self explanatory given what I've found tooling around the software without real documentation)