[NTG-context] Re: Wiki - test/proposal to further clarify documentation

[Henning Hraban Ramm <texml@fiee.net>]

Am 17.04.24 um 23:25 schrieb Garulfo:
> - exactly, it's not a question of proposing new documents, but of 
> proposing another complementary way of accessing and browsing existing 
> ones.
> 
> - Actually, the wiki is (or can be) a hub for the 4 needs:
>    - "Reference" like https://wiki.contextgarden.net/Command/setuphead
>    - "How-To Guides" like https://wiki.contextgarden.net/Titles
>    - "Tutorials":
>      - hosted https://wiki.contextgarden.net/Detailed_Example
>      - linked https://github.com/mpsmath/stepbystep
>    - "Explanation" : mostly linked manuals and books
> 
> 
> https://wiki.contextgarden.net/Command/setuphead
> and https://wiki.contextgarden.net/Titles
> are examples of how difficult it can be to understand where to find a 
> particular information.
> 
> It might be worth keeping only the key examples on reference pages
> like https://wiki.contextgarden.net/Command/***
> and moving the "how-to" examples to a separate page (or pages).

I agree. Let’s accept this as a rule for further wiki editing.

Also, explain parameters with top priority in Command/setup* pages 
(keeping them in Command/define* pages etc. doesn’t hurt, but at least 
experienced users should know where to find something without searching).

Hraban
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl
webpage  : https://www.pragma-ade.nl / https://context.aanhet.net (mirror)
archive  : https://github.com/contextgarden/context
wiki     : https://wiki.contextgarden.net
___________________________________________________________________________________