I apologize to everybody for suggesting something that I thought would be beneficial, because I see now there is no way to put in what I was thinking without a complete overhaul of the documentation's architecture.
When I inspect https://tiddlywiki.com/#%24%3A%2Feditions%2Ftw5.com%2Foperator-macros, I realize the entire architecture of the thing is way too complex to change, and way too complex for me to ever consider helping out. The process was already too complex for me, and now I see the architecture is not something I can handle. So hats off to the folk who can wrap their brains around that, because I have neither the time nor the desire to put in the effort to figure that out. On Friday, April 1, 2022 at 11:59:46 AM UTC-3 PMario wrote: > On Friday, April 1, 2022 at 2:24:30 PM UTC+2 [email protected] wrote: > >> Yes, I know that. I'm not asking for myself. My point is that it should >> be easy for anybody to learn about all TiddlyWiki features involved in any >> example in the documentation. >> > .... > >> It is sad and disappointing that TiddlyWiki features are being used in >> the documentation, but the very usage not documented. Lost opportunities. >> > > OK. So a little bit of info for those, who want directly contribute to the > TW docs. > > You are right. ... Documenting "the documentation" is an option, to show > users what's possible. I think the needs of the TW docs are very specific. > But still -- one can learn a lot from it. > > We -- the core devs -- need help from the community if that "meta" content > should be there. > > There is a lot of work to do for the reference documentation. Detailed > documentation "how the doc macros work" will add to the existing work that > "should be already done" ... > > The TW documentation is a community effort and everyone is welcome to > create content and contribute it. > > I did create a HowTo: 7 Steps to improve the tiddlywiki documentation > <https://talk.tiddlywiki.org/t/7-steps-to-improve-the-tiddlywiki-documentation/2590> > > at "Talk TiddlyWiki". I also did create a video series, that shows how to > use it. The link to the videos can be found at the HowTo. > > Discussion and feedback can happen at Talk > <https://talk.tiddlywiki.org/t/discussion-7-steps-to-improve-the-tiddlywiki-documentation/2909> > > too. > > Saq, did create a "working prototype" Wiki that is online, can be modified > and can create contributions, that can directly be implemented into the > "living" docs at tiddlywiki.com. (Link in the HowTo) > > There is a Documentation Styleguide > <https://tiddlywiki.com/#Documentation%20Style%20Guide> and an overview > about the Documentation macros > <https://tiddlywiki.com/#Documentation%20Macros> at tiddlywiki.com .. (By > the way, I'm talking about those elements in the Video mentioned in the > HowTo.) > > Contributions to the documentation can be successful, if users loosely > follow the style-guide. Nothing can be broken. It may take several > iterations till something can be accepted. > > So everyone, that wants to help us to improve the docs, so we don't loose > opportunities can have a closer look at: 7 Steps to improve the > tiddlywiki documentation > <https://talk.tiddlywiki.org/t/7-steps-to-improve-the-tiddlywiki-documentation/2590> > > > Have fun! > mario > > -- You received this message because you are subscribed to the Google Groups "TiddlyWiki" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/tiddlywiki/c0b4f4af-d857-4239-9729-947c6d3dc010n%40googlegroups.com.
