ntg-context - mailing list for ConTeXt users
 help / color / mirror / Atom feed
From: "Rob Heusdens" <robheus@xs4all.nl>
To: "mailing list for ConTeXt users" <ntg-context@ntg.nl>
Subject: Re: State of documentation of ConTeXt?
Date: Wed, 16 Jul 2014 13:24:59 +0200	[thread overview]
Message-ID: <eae7a49ac782e98f4ccc0e31b70044ff.squirrel@webmail.xs4all.nl> (raw)
In-Reply-To: <CALBOmsbeNYnRTFVzT58f=GERcjpLgXcG=GX6wmSn=VZ6xZarzQ@mail.gmail.com>


> I agree that it would be awesome if there was complete documentation
> available + maybe three manuals/tutorials from beginner to master, but
> you cannot expect it from Hans to do all the work on his own.
>
> Mojca
>

I think that part of the work has to be done by other volunteers (users),
who have enough experience to write in good style user documentation. That
kind of work does not depend on Hans or Taco alone. I think their
important task is to have the technical documentation up-to-date and/or
provide well enough information about the changes in releases, that others
can write good user-documentation.

First priority I guess would be to have the contextgarden Wiki up-to-date:
many commands and/or parameters are not touched there. There are many
outdate pages (with broken links, etc.), and definatately I would guess a
better split is needed between MkII and MkIV wherever applicable.

If time and experience-level allows me, I would like to start working on
that kind of things. Someday I would also like to write a user-manual for
Context novices (and ppl. new to Tex in general). But first I need to sort
out some things myself, esp. about the whole font-mechanism, and how
Context handles it. And as of yet I have no clue on what is what in the
Context/Tex tree and where to find all the sources. Keeps me busy some
time...

Greetings,

Rob
--------
PS. And also material on 'good typography' would come in handy as weblinks
and in Context user-manuals. Yesterday, I read this online typography
manual, which contains some usefull tips about Typography. See:
http://practicaltypography.com/index.html#toc

I see that he also uses protrusion in the left-margin for quotations (when
you start a sentence on a new line with a quotation), something which
Context atm. does not do, only in the right margin, but the result is
good. Definately some feature request.

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


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


  reply	other threads:[~2014-07-16 11:24 UTC|newest]

Thread overview: 25+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2014-07-14 12:18 Gerben Wierda
2014-07-14 13:03 ` Rob Heusdens
2014-07-14 17:29   ` Hans Hagen
2014-07-15  9:59     ` Gerben Wierda
2014-07-15 14:42       ` Mojca Miklavec
2014-07-16 11:24         ` Rob Heusdens [this message]
2014-07-16 12:14         ` Alan BRASLAU
2014-07-16 15:08           ` Russ Urquhart
2014-07-16 15:20             ` Hans Hagen
2014-07-16 15:23               ` luigi scarso
2014-07-17 16:28             ` Mica Semrick
2014-07-15 14:55       ` luigi scarso
2014-07-15 15:33         ` Yuri Teixeira
2014-07-15 20:08           ` Hans Hagen
2014-07-15 20:23       ` Hans Hagen
2014-07-15 22:26       ` David Wooten
2014-07-15 22:54         ` Hans Hagen
2014-07-15 23:10           ` David Wooten
2014-07-16  6:30           ` Gour
2014-07-20 12:14         ` Gerben Wierda
2014-07-20 14:55           ` Gerben Wierda
2014-07-20 20:24           ` Mojca Miklavec
2014-07-20 21:07             ` Gerben Wierda
2014-07-21  3:07               ` Henning Hraban Ramm
2014-07-23 12:36               ` Ulrike Fischer

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=eae7a49ac782e98f4ccc0e31b70044ff.squirrel@webmail.xs4all.nl \
    --to=robheus@xs4all.nl \
    --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).