Hello,
I want to propose a new structure for the TiddlyWiki documentation. In my
opinion, improving the documentation in every aspect will make TW not only
more useful but a lot more popular and attractive. The general idea is a
more formal (standardized) and concise documentation structure. I don't
mean to offend anyone but to share my experience and maybe to save other
from the frustrations and obstacles I've ran into in the process of
learning TW. Don't get me wrong, I'm not near an TW expert I just consider
that the quality of the documentation can be raised a bit to make it look
more professional.
*Proposed improvements*
- Less confusing and more concise chapter titles. - e.g. "Basic Usage"
instead of "Learning"
- Higher level of abstraction and specialization – maybe more
hierarchical levels.
- Chapters (and their contents) should have a more natural (logical) and
progressive order.
- A clear distinction between different types of documentation (e.g.
guides vs. references) - guides will be mostly used by beginners and
references by advanced users.
- Chapters should be discrete areas of interests with a specialized role
– not every user have time to read all the docs before creating the
simplest thing - get things done now, read the concept behind them later
(when there's time for this).
- The panel title should be "Docs" or "Help" not "Contents" (minor).
*Proposed structure*
*GUIDES*
- *Welcome (a presentation similar to HelloThere)*
- *How to read the documentation*
- *Getting started*
- What is TiddlyWiki
- Comparison with other wikis/knowledge management tools
- Choosing an edition
- ...
- *Installation and basic configuration*
- Downloading and installing
- Setting a backup routine
- - ...
- *Basic usage*
- Site navigation
- Create and edit tiddlers
- Search tiddlers
- ...
- *Advanced usage*
- Creating and using macros
- Using built-in widgets
- ...
- *Configuring and customize*
- Changing site title and subtitle
- Setting a favicon
- ...
- *Administration and maintenance*
- Updating TiddlyWiki
- ...
- *Extending and developing*
- Creating and using plugins
- Creating and modifying themes
- Developing modules
- ...
- *Seeking for help*
- Known problems and limitations
- Post a question on a TidldyWiki Forum
- ...
- *Helping the community*
- How to report a bug
- How to contribute a fix/improvement
- ...
*REFERENCES*
- *Concepts*
- *Examples*
- *Dictionary*
- *TiddlyWiki Editions*
- *External resources*
- Forums
- *Community resources*
- Plugins
- Sites
- *About*
Thanks!
--
You received this message because you are subscribed to the Google Groups
"TiddlyWikiDev" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to tiddlywikidev+unsubscr...@googlegroups.com.
To post to this group, send email to tiddlywikidev@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywikidev.
To view this discussion on the web visit
https://groups.google.com/d/msgid/tiddlywikidev/6d7cf3f2-6ae1-4b9c-9a9d-e305e032d60d%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
