@Mohammad if you look at the list I referenced, I am very confident that writing documentation for the following is well within the abilities of most of the people participating in this thread:
- Filter run prefix documentation tiddlers missing for most prefixes
- even ignoring the newer prefixes, we need documentation for the very old ones like +, ~ and even the no prefix case. There are examples to follow that already exist for the structure of the documentation.
- Examples for insertbefore operator
- Examples missing for haschanged operator
- Provide examples for the ButtonWidget
From my point of view there isn’t much of argument to be made claiming that documentation cannot be written due to a lack of understanding, when the ones that easily could be written are still wanting for attention.
Furthermore, many cases of people claiming that documentation is lacking are not carefully reading what is already there.
Take the EventCatcherWidget for example, the documentation is complete and includes a functional example. It also mentions that it is an advanced widget that requires understanding of HTML and DOM events. It isn’t intended for everyone, we have other widgets that are easier to use and do not require such knowledge, the entire TiddlyWiki user interface has been built without EventCatcher for instance.
Teaching users about HTML and the DOM is far outside the scope of what TiddlyWiki documentation should be expected to explain. However for users willing to spend the time to understand the relevant concepts about the DOM, this opens up a lot of interesting possibilities without ever needing to write or understand JavaScript. This in itself is a significant achievement, it cannot be simplified further - well it can but then we end up with widgets like the ButtonWidget which we already have.