Re: [NTG-context] documentation sprint at 10th ConTeXt meeting

2016-01-25 Thread Jan U. Hasecke 
Am 25.01.2016 um 15:55 schrieb Wolfgang Schuster:
> Hans has a version info on his page for each PDF, e.g.
> http://pragma-ade.com/show-man-1.htm

In the "Manual" and in "Getting started" there is no mention of the new
startchapter command, which is mentioned on the wiki as a replacement of
the old \chapter command.

I know that \chapter is working just fine, but when the new command is
startstopchapter it would be nice to read about it.

juh
___
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
___

Re: [NTG-context] documentation sprint at 10th ConTeXt meeting

2016-01-25 Thread Wolfgang Schuster 

Jan U. Hasecke 
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
___
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
___

[NTG-context] documentation sprint at 10th ConTeXt meeting

2016-01-25 Thread Jan U. Hasecke 
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.

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.

juh

-- 
Software-Dokumentation mit Sphinx
http://www.amazon.de/dp/1497448689/
Paperback: 224 Seiten
___
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
___

Re: [NTG-context] documentation sprint at 10th ConTeXt meeting

2016-01-25 Thread Hans Hagen 

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

Re: [NTG-context] documentation sprint at 10th ConTeXt meeting

2016-01-25 Thread Alan BRASLAU 
On Mon, 25 Jan 2016 17:44:09 +0100
Hans Hagen  wrote:

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

Documentation is an ongoing project... we discuss this regularly at the
ConTeXt users meetings and make great resolutions about completing and
updating it all. As Hans and Wolfgang point out, quite a lot of
documentation is available on the Pragma website and more and more
documentation is being included in the distribution. There are ongoing
efforts to update older documents and new documents are being written.

We will definitely discuss this some more at the next meeting.

Alan
___
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
___

Re: [NTG-context] documentation sprint at 10th ConTeXt meeting

2016-01-25 Thread Jan U. Hasecke 
Am 25.01.2016 um 18:20 schrieb Alan BRASLAU:
> On Mon, 25 Jan 2016 17:44:09 +0100
> Hans Hagen  wrote:
> 
>>> 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)
> 
> Documentation is an ongoing project... we discuss this regularly at the
> ConTeXt users meetings and make great resolutions about completing and
> updating it all. As Hans and Wolfgang point out, quite a lot of
> documentation is available on the Pragma website and more and more
> documentation is being included in the distribution. There are ongoing
> efforts to update older documents and new documents are being written.
> 
> We will definitely discuss this some more at the next meeting.

Great to hear that a sprint is planned.

I am not sure what kind of abstract I should send to Alan. If a sprint
is planned we could setup a sprint planning etherpad somewhere an add
items there so that participants can choose an item to work on.

juh

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