Hello to everyone involved here in the project. I want to share the result of the survey here (minus the personal data). I will try to interpret this a bit.
However, only 5 people did participate in the survey. So, the results cannot be considered as well-posed statistics but only a very small sample.
Is the documentation page known?
The main intention was if the enhancement of the documentation in the named page does even make sense. If not, more promotion or a better format might be considerable.
The interpretation is not very representative as too few people have participated but there is at least a favor for the knowledge of the page. So, I’d say, we can use it as a communication platform of documentation and try to promote further.
The question here is how much documentation to write in general. We do not want to put too much manpower into documentation if it is not read anyways.
First good point is that no participant was lost on the app’s usage and requested more information. This means we did not mess up the UI completely .
Apart from that, quite some users would have anticipated some beginner’s documentation.
In order to write user-centered documentation, one needs to know what topics to enhance. There was a free-form text to state something else.
The main request seems to be related to the usage and administration of the app. However, when looking at the individual answers, it seems that there are two groups of users (also comparing/correlating with other answers):
- The tech-savvy ones that are more into administration and potential participation in the development
- The normal users of the app that need an introduction to how to use the app.
Help by the community
For the sake of saving manpower on the programming part, the question is if the community is able to participate in the documentation and keeping it up to date. That would allow the documentation to evolve also without binding too many resources.
One can see that a majority of users are not able or willing to help. This is not necessarily surprising as the survey was not posed within a group of power users but in a mixed environment.
The other (two) users were willing to help but were not aware of the possibility or the possible topics. I will contact them separately soon. We will see how we can get this running.
Anyways, if you find a topic that needs documentation coverage, please feel free to contact me on GitHub or here. We need mainly a good structure and the requirements for a good documentation. If you contact me here, don’t forger to mention me using @christianlupus.
The final question was if there was something missing in the survey. I put it here for sake of completeness.
Regarding the sharing of recipes, we are on your war to restructure the source code to allow this. At the moment it is not possible to to missing fine-grained data storage. This is on the agenda as soon as our tests are running and we are sure, we are not breaking the complete system.
We appreciate the thanks for the app very much!
Regarding the exiting documentation and experience writing it, as stated above, I will contact you soon.
Thank you for participating!