From: Michael Saunders <odradek5@gmail.com>
To: ntg-context@ntg.nl
Subject: Re: Microtype in ConTeXt
Date: Sat, 27 Mar 2010 12:43:38 -0500 [thread overview]
Message-ID: <54d7f5601003271043h1b9d0a4dxcfbdc45eddda5b3e@mail.gmail.com> (raw)
> On 27-3-2010 1:15, Yan Zhou wrote:
>
>> As I can see now ConTeXt is indeed a far more advanced system than LaTeX. But I have one more query. Where can I find the documents. When following these replies and some other messages in the list, I find some commands not documented in the Manual or Reference Manual. In LaTeX, all commands are detailed documented in source2e.tex, in TeX, The TeXBook explains everything. So in ConTeXt, where can I find such detailed documents. I tried the documented source, but it is more like a PDF version or source with only a little documentation.
>
> as most of the functrionality does not change you can use older docs
> (website, wiki etc) for most cases
>
> newer things i.e. introduced in mkiv using luatex are described in for
> instance mk.pdf and articles
>
> of course the wiki is a good source as well
Notice that Yan Zhou isn't complaining that the docs are old. Our
problem is that they are sketchy and rambling, bits and pieces of this
and that without any systematic explanations. Often they are just
some unexplained code samples that communicate nothing (unless you
happen to be the guy who invented the language). I can't think of
one command that is fully explained along with all its possible
parameters. The wiki is better written, but even less complete. It
might not be possible to do better, but this is a huge obstacle to
anyone who actually wants to use ConTeXt. The docs hint at a lot of
features that sound better than LaTeX, but actually getting them to
work is a different story.
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!
maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage : http://www.pragma-ade.nl / http://tex.aanhet.net
archive : http://foundry.supelec.fr/projects/contextrev/
wiki : http://contextgarden.net
___________________________________________________________________________________
next reply other threads:[~2010-03-27 17:43 UTC|newest]
Thread overview: 15+ messages / expand[flat|nested] mbox.gz Atom feed top
2010-03-27 17:43 Michael Saunders [this message]
2010-03-27 20:04 ` docs (was: Re: Microtype in ConTeXt) Peter Münster
-- strict thread matches above, loose matches on Subject: below --
2010-03-25 1:55 Microtype in ConTeXt Yan Zhou
2010-03-25 14:09 ` Hans Hagen
2010-03-25 14:28 ` Wolfgang Schuster
2010-03-25 15:21 ` Hans Hagen
2010-03-25 15:34 ` Wolfgang Schuster
2010-03-25 15:39 ` Hans Hagen
2010-03-25 18:14 ` Wolfgang Schuster
2010-03-25 22:42 ` Hans Hagen
2010-03-27 0:15 ` Yan Zhou
2010-03-27 9:24 ` Hans Hagen
2010-03-27 5:28 ` Wolfgang Schuster
2010-03-27 11:21 ` Hans Hagen
2010-03-27 12:58 ` Wolfgang Schuster
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=54d7f5601003271043h1b9d0a4dxcfbdc45eddda5b3e@mail.gmail.com \
--to=odradek5@gmail.com \
--cc=ntg-context@ntg.nl \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).