Am 14.04.24 um 21:45 schrieb Peter Hopcroft via ntg-context:

It would be great if the main page actually said what Context does.

In my poster (still WIP) I wrote: start --- The “infamous” alternative to LaTeX While most designers use graphical tools, there are still areas where code-based typesetting systems are fun, make sense or are even superior. While LaTeX is the most known of these, ConTeXt is used by a growing minority of ambitioned enthusiasts around the world. The small but active and creative community of ConTeXt users and developers is always driving TeX development over new frontiers: NTS, MetaFun, Oriental TeX, LuaTeX, mplib, LuaMetaTeX… They’re also dubbed the incisors (AKA cutting edge) of the dinosaur of Open Source. ConTeXt is aimed at creative users, known for advanced features like extensive font control and direct XML processing, with a deep integration of Lua and MetaPost. --- ConTeXt was invented in the 1990s by Hans Hagen and Ton Otten of the Dutch company “Pragma Advanced Document Engineering” for typesetting schoolbooks. Taco Hoekwater refactored the TeX source code to create LuaTeX which was further developed into LuaMetaTeX by Hans Hagen (and lately Mikael Sundqvist for refined math typography). --- “To be fair, switching to the ConTeXt way of thinking and doing things was not an overnight process […]. But once I got used to it, I could not imagine going back to LaTeX. I’ll go even further and say that, in my view, ConTeXt is the future of TeX. (Prof. Idris Samawi Hamid, 2009) Source: www.tug.org/interviews/hamid.html --- “ConTeXt is LaTeX done right. It is simple, flexible and powerful.” (J. U. Hasecke on Mastodon, 2022) --- Is ConTeXt for me? If you want … * to design your own layout * best quality math typesetting * to use Lua functions e.g. for processing data * deep integration of a graphics language (MetaPost) * to process XML input * no package conflicts * to use OpenType features * consistent setup commands * to place stuff on layers * visual debugging features * to have a lean, but mighty TeX system * to typeset much faster than with LaTeX * high quality Arabic typography … then ConTeXt is for you! --- stop

On 16. Apr 2024, at 21:56, Peter Hopcroft via ntg-context wrote:

...

On 17/04/2024, at 7:11 AM, Henning Hraban Ramm wrote:

In my poster (still WIP) I wrote: …

Excellent

No, I must admit I don’t like the first two paragraphs. The question is “what is ConTeXt,” and the answer is “we’re not LaTeX.” And why “infamous”? Thomas

Am 17.04.24 um 10:36 schrieb Hans Hagen:

On 4/17/2024 8:32 AM, Thomas A. Schmitz wrote:

...

...

On 16. Apr 2024, at 21:56, Peter Hopcroft via ntg-context wrote:

...

On 17/04/2024, at 7:11 AM, Henning Hraban Ramm wrote:

In my poster (still WIP) I wrote: …

Excellent

No, I must admit I don’t like the first two paragraphs. The question is “what is ConTeXt,” and the answer is “we’re not LaTeX.” And why “infamous”?

I agree. It sounds the same as "we're not msword" or "we're not google docs". (In the end the only thing that latex and context have in common is that they use the tex language / ecosystem.)

In my experience, most people interested in ConTeXt know LaTeX, so it makes sense to compare. And I actually just say “LaTeX is the most known command-based typesetting system” (that’s just true) to shortcut explaining what a cbts might be. Your critique applies to JUH’s quote, though. I used “infamous” as a funny way to say “not famous, but somewhat known” (and yes, I know Latin and what the words really mean). Hraban

Unfortunately, despite all that has been said, we have to realise what words actually mean in English, and 'infamous' has a negative connotation. So I recommend rephrasing this and perhaps the entire paragraph so that it presents a positive perspective on ConTeXt. But if you mean 'less known' then simply say that: ConTeXt is the less known alternative to LaTeX. and rather than 'growing minority', say 'growing number'. We do not say 'ambitioned enthusiasts' in English, but we could say 'ambitious enthusiasts'. Julian On 17/4/24 19:10, Joaquín Ataz López wrote:

...

I used “infamous” as a funny way to say “not famous, but somewhat known” (and yes, I know Latin and what the words really mean). That was my understanding. Infamous=Not famous; that is, not as well known as others. A slight play on words.

Am 17.04.24 um 13:57 schrieb Bruce Horrocks:

- There are at least two books, and a third being written but not yet released: these fit into the Tutorials and Explanation quadrants.

Which published books do you mean? I know of Alan Braslau’s book, AFAIK that will be published in French “soon” and probably later in English. My German book is still not ready, while I work on it regularly. Of course there are a lot of PDFs (most with sources), not only in the distribution, but also in https://github.com/contextgarden/not-so-short-introduction-to-context Hraban

Le 17/04/2024 à 13:57, Bruce Horrocks a écrit :

...

On 14 Apr 2024, at 12:21, garulfo@azules.eu wrote:

Hi all,

I just discover the Diátaxis documentation framework :

I'd be more confident if you had started by saying "I've been using the Diátaxis for the last ten years and have used it on multiple projects". ;-)

...

- https://www.diataxis.fr/ - 30min video : "What nobody tells you about documentation", https://www.youtube.com/watch?v=t4vKPhjcMZg , from Daniele Procida at PyCon 2017

As I understand it, it can help both readers and writers of the documentation by clarifying the purpose of each element.

So I started a potential new "welcome page" : https://wiki.contextgarden.net/Main_Page2

The main lines would be : - Tutorials: installation pages, step by step examples - How-to guides: most of the existing wiki pages which are not https://wiki.contextgarden.net/Commands/ ... - Discussions and manuals: most of the existing manuals - Reference : the pages dedicated to commands which already include link to mailing list, stack exchange, ConTeXt's source - https://wiki.contextgarden.net/Category:Commands - https://wiki.contextgarden.net/Special:PrefixIndex?prefix=Command%2F

To match the logic of Diátaxis, maybe some material from command pages should be moved from "Reference" to "How-to guides", for example, when the examples go beyond "pure description" and begin to deal with "how-to" cases, e.g. : - Reference for setuphead: https://wiki.contextgarden.net/Command/setuphead - How-to guides for headings: https://wiki.contextgarden.net/Titles

If it make sense, and according to your feedbacks, I can continue to reallocate existing contents.

Thanks for your feedback and thoughts.

I'm going to be devil's advocate and say that the Context documentation is *already* in the Diátaxis framework - just not in one place on the Wiki.

- There are at least two books, and a third being written but not yet released: these fit into the Tutorials and Explanation quadrants.

- There are "My Way" guides linked from the Wiki and the PragmaADE website that fit into the "How-To Guides" quadrant.

- thank you for these reminders

- And the wiki itself is the "Reference" quadrant.

Clearly these can always be better but they are there already. My recommendation would be to use the wiki as the reference quadrant and, apart from the first few "main pages" for people who land there from a web search, it should focus on being the reference manual. Beginners should be directed to the books.

- Thanks again, the comments are helping to identify a robust method of distributing content across the quadrants. - 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).

Regards, — Bruce Horrocks Hampshire, UK

___________________________________________________________________________________ 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 ___________________________________________________________________________________

So is the plan to go through each of the main headings in the left side-bar and make the same type of change? Yes.

Maybe new ones will have to be added