Jan U. Hasecke mailto:juh+ntg-context@mailbox.org 25. Januar 2016 um 15:44 Dear list,

are there any plans to have a documentation sprint at Kalenberg?

I am currently trying to setup a small documentation about ConTeXt in order to better learn how to use it, and I face several issues.

1. documentation is scattered. Sources of documentation are the Wiki and a lot of PDF documents.

2. it is not always possible to decide whether a pdf document is related to MKII or MKIV. So I start reading only to learn that it is outdated. Hans has a version info on his page for each PDF, e.g. http://pragma-ade.com/show-man-1.htm

Wolfgang

On 1/25/2016 3:44 PM, Jan U. Hasecke wrote:

Dear list,

are there any plans to have a documentation sprint at Kalenberg?

yes

I am currently trying to setup a small documentation about ConTeXt in order to better learn how to use it, and I face several issues.

1. documentation is scattered. Sources of documentation are the Wiki and a lot of PDF documents.

there are also some in the distribution

2. it is not always possible to decide whether a pdf document is related to MKII or MKIV. So I start reading only to learn that it is outdated.

much mkii applies to mkiv (but you can forgot about things like encodings and such so for fonts best consult the latest)

3. I had the hope to access all commands via the xml interface mechanism (showsetup) which could be a kind of auto generated documentation (using: mtxrun --script server --auto) but it seems that not all commands are accessible through this mechanism

I would like to propose a documentation sprint at the meeting in Kalenberg this fall to improve the situation.

sure, just mail an abstract to Alan (who chairs the prog committee) Hans ----------------------------------------------------------------- Hans Hagen | PRAGMA ADE Ridderstraat 27 | 8061 GH Hasselt | The Netherlands tel: 038 477 53 69 | www.pragma-ade.com | www.pragma-pod.nl -----------------------------------------------------------------