* documentation sprint at 10th ConTeXt meeting
@ 2016-01-25 14:44 Jan U. Hasecke
2016-01-25 14:55 ` Wolfgang Schuster
2016-01-25 16:44 ` Hans Hagen
0 siblings, 2 replies; 6+ messages in thread
From: Jan U. Hasecke @ 2016-01-25 14:44 UTC (permalink / raw)
To: ntg-context
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
___________________________________________________________________________________
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: documentation sprint at 10th ConTeXt meeting
2016-01-25 14:44 documentation sprint at 10th ConTeXt meeting Jan U. Hasecke
@ 2016-01-25 14:55 ` Wolfgang Schuster
2016-01-25 15:17 ` Jan U. Hasecke
2016-01-25 16:44 ` Hans Hagen
1 sibling, 1 reply; 6+ messages in thread
From: Wolfgang Schuster @ 2016-01-25 14:55 UTC (permalink / raw)
To: mailing list for ConTeXt users
[-- Attachment #1.1: Type: text/plain, Size: 659 bytes --]
> 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
[-- Attachment #1.2: Type: text/html, Size: 1721 bytes --]
[-- Attachment #2: Type: text/plain, Size: 485 bytes --]
___________________________________________________________________________________
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
___________________________________________________________________________________
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: documentation sprint at 10th ConTeXt meeting
2016-01-25 14:44 documentation sprint at 10th ConTeXt meeting Jan U. Hasecke
2016-01-25 14:55 ` Wolfgang Schuster
@ 2016-01-25 16:44 ` Hans Hagen
2016-01-25 17:20 ` Alan BRASLAU
1 sibling, 1 reply; 6+ messages in thread
From: Hans Hagen @ 2016-01-25 16:44 UTC (permalink / raw)
To: ntg-context
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
___________________________________________________________________________________
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: documentation sprint at 10th ConTeXt meeting
2016-01-25 16:44 ` Hans Hagen
@ 2016-01-25 17:20 ` Alan BRASLAU
2016-01-25 18:36 ` Jan U. Hasecke
0 siblings, 1 reply; 6+ messages in thread
From: Alan BRASLAU @ 2016-01-25 17:20 UTC (permalink / raw)
To: ntg-context
On Mon, 25 Jan 2016 17:44:09 +0100
Hans Hagen <pragma@wxs.nl> 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
___________________________________________________________________________________
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: documentation sprint at 10th ConTeXt meeting
2016-01-25 17:20 ` Alan BRASLAU
@ 2016-01-25 18:36 ` Jan U. Hasecke
0 siblings, 0 replies; 6+ messages in thread
From: Jan U. Hasecke @ 2016-01-25 18:36 UTC (permalink / raw)
To: mailing list for ConTeXt users
Am 25.01.2016 um 18:20 schrieb Alan BRASLAU:
> On Mon, 25 Jan 2016 17:44:09 +0100
> Hans Hagen <pragma@wxs.nl> 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
___________________________________________________________________________________
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2016-01-25 18:36 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2016-01-25 14:44 documentation sprint at 10th ConTeXt meeting Jan U. Hasecke
2016-01-25 14:55 ` Wolfgang Schuster
2016-01-25 15:17 ` Jan U. Hasecke
2016-01-25 16:44 ` Hans Hagen
2016-01-25 17:20 ` Alan BRASLAU
2016-01-25 18:36 ` Jan U. Hasecke
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).