@Mohammad there is a list of documentation tiddlers that need work and the vast majority of them do not need any special developer insight to write. Most of those topics that are listed as needing documentation should be familiar enough for users that have been fiddling with wikitext for a while.
Sadly there have only been two community members that have stepped up to contribute. Lots of gratitude and respect for @Mark_S and @btheado, thank you!
This is lack of contributions is particularly disappointing considering that the barriers to contributing to documentation are very low now. If people don’t like the format of the core documentation and want to write it differently, what is stopping them? Go for it. As you say, we could definitely benefit from other styles of documentation to complement the core reference documentation on tiddlywiki.com.
I must admit that I personally find it very frustrating when people just keep complaining without using any of that time constructively at all, that is not contributing to solving the problems where it is within there skillset to do so, and often just complaining because they haven’t thoroughly read the documentation that is already there. If people don’t want to contribute to solving what they see as problems with the documentation, who is that they expect to do so and why do they think that expectation is reasonable?
Either we all step up and fix the shortcomings together, or if the community wants developers to write the documentation for them, then let’s collect some funds and hire someone to do it…assuming anyone is even willing! Everyone involved in the project is a volunteer and I do think that what is being asked for - particularly of developers - is outside the scope of what one can reasonably and reliably expect of volunteers who already give a lot of their time to this project.
Last but not least, in my experience with open source projects of similar scale, TW documentation is actually very good
Apologies if this comes across as a bit of rant @Mohammad and it definitely isn’t aimed at you. I personally find the experience of being a developer contributing to this project to be an increasingly thankless job, wherein I often perceive my efforts to be met with hostility by the community, despite always striving to represent the needs of end users in discussions around the core.