From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/96396 Path: news.gmane.org!.POSTED!not-for-mail From: Jonas Baggett Newsgroups: gmane.comp.tex.context Subject: Re: Ideas for improving documentation of ConTeXt Date: Mon, 10 Oct 2016 07:43:01 +0200 Message-ID: <9c16c6a0-2c9f-3205-36ef-21e7cb41bdfc@tranquille.ch> References: <57FAADBE.3050703@gmail.com> Reply-To: mailing list for ConTeXt users NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="===============0192928595498138526==" X-Trace: blaine.gmane.org 1476078242 7171 195.159.176.226 (10 Oct 2016 05:44:02 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 10 Oct 2016 05:44:02 +0000 (UTC) User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.11; rv:45.0) Gecko/20100101 Thunderbird/45.4.0 To: ntg-context@ntg.nl Original-X-From: ntg-context-bounces@ntg.nl Mon Oct 10 07:43:57 2016 Return-path: Envelope-to: gctc-ntg-context-518@m.gmane.org Original-Received: from zapf.boekplan.nl ([5.39.185.232] helo=zapf.ntg.nl) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1btTN9-0007Sa-LV for gctc-ntg-context-518@m.gmane.org; Mon, 10 Oct 2016 07:43:35 +0200 Original-Received: from localhost (localhost [127.0.0.1]) by zapf.ntg.nl (Postfix) with ESMTP id 9DBD01A9D7; Mon, 10 Oct 2016 07:43:23 +0200 (CEST) X-Virus-Scanned: Debian amavisd-new at zapf.boekplan.nl Original-Received: from zapf.ntg.nl ([127.0.0.1]) by localhost (zapf.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 4CJ1qEgf8MyC; Mon, 10 Oct 2016 07:43:21 +0200 (CEST) Original-Received: from zapf.ntg.nl (localhost [IPv6:::1]) by zapf.ntg.nl (Postfix) with ESMTP id 685461A9C8; Mon, 10 Oct 2016 07:43:21 +0200 (CEST) Original-Received: from localhost (localhost [127.0.0.1]) by zapf.ntg.nl (Postfix) with ESMTP id BBE5D1A916 for ; Mon, 10 Oct 2016 07:43:20 +0200 (CEST) X-Virus-Scanned: Debian amavisd-new at zapf.boekplan.nl Original-Received: from zapf.ntg.nl ([127.0.0.1]) by localhost (zapf.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id G48ibQFyCT6b for ; Mon, 10 Oct 2016 07:43:19 +0200 (CEST) Original-Received: from smtp-sh2.infomaniak.ch (smtp-sh2.infomaniak.ch [128.65.195.6]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by zapf.ntg.nl (Postfix) with ESMTPS id C80131A90B for ; Mon, 10 Oct 2016 07:43:09 +0200 (CEST) Original-Received: from smtp6.infomaniak.ch (smtp6.infomaniak.ch [83.166.132.19]) by smtp-sh.infomaniak.ch (8.14.5/8.14.5) with ESMTP id u9A5h8pg013860 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL) for ; Mon, 10 Oct 2016 07:43:08 +0200 Original-Received: from MacBook-Air-de-Jonas.fritz.box ([194.191.235.173]) (authenticated bits=0) by smtp6.infomaniak.ch (8.14.5/8.14.5) with ESMTP id u9A5h22k061872 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO) for ; Mon, 10 Oct 2016 07:43:08 +0200 In-Reply-To: <57FAADBE.3050703@gmail.com> X-Antivirus: Dr.Web (R) for Unix mail servers drweb plugin ver.6.0.2.8 X-Antivirus-Code: 0x100000 X-BeenThere: ntg-context@ntg.nl X-Mailman-Version: 2.1.16 Precedence: list List-Id: mailing list for ConTeXt users List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: ntg-context-bounces@ntg.nl Original-Sender: "ntg-context" Xref: news.gmane.org gmane.comp.tex.context:96396 Archived-At: This is a multi-part message in MIME format. --===============0192928595498138526== Content-Type: multipart/alternative; boundary="------------3EAB22CA6FC5B5EF772E8C13" This is a multi-part message in MIME format. --------------3EAB22CA6FC5B5EF772E8C13 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 8bit Hello Wolfgang, Le 09. 10. 16 à 22:51, Wolfgang Schuster a écrit : > Many of the old manuals got updates by Hans and he included the PDF’s > (together with the source files) in the normal ConTeXt download, you > can find them in the doc folder in your ConTeXt installation. Ok, I don't have enough the habit of consulting documentation that is installed in my system. I have found something interesting here that could be helpfull to me : /usr/share/texmf/doc/context/base/examplap/gui/letter.pdf. It seems to be a letter generator, but unfortunately I wasn't able to make it work. Maybe it is outdated since it is 10 years old. > The wiki has a page for examples and you’re free to update the > existing examples or add new ones. Do you mean http://wiki.contextgarden.net/Sample_documents ? Yes, that's a good idea, since I believe that it is a way to improve documentation with little efforts. Then I plan to add the cover letter style I made since I am happy with the results, although 1 or 2 things could have some improvement. There are also some letter styles there, then I will have a look on them too. I don't know if people are intimidated about writing contents in the wiki because it is the official wiki and feel that only programmers are supposed to update it, but it will be really helpfull if the users have more the habit of posting there the document styles they made. > Sounds interesting and the best thing you can do is to start with it. Thanks for your encouragement ! Yes that looks like an interesting challenge for me, but it is not something I am wanting to do alone because of my lack of experience, at least I would need someone to coach me. Actually I don't have really experience with web developpment and I would at least need help for the technological choices. Having someone that tells me that if I use technology X, there are module Y and Z that will be a good fit is a good start. Have a nice day, Jonas --------------3EAB22CA6FC5B5EF772E8C13 Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: 8bit

Hello Wolfgang,


Le 09. 10. 16 à 22:51, Wolfgang Schuster a écrit :
Many of the old manuals got updates by Hans and he included the PDF’s (together with the source files) in the normal ConTeXt download, you can find them in the doc folder in your ConTeXt installation.

Ok, I don't have enough the habit of consulting documentation that is installed in my system. I have found something interesting here that could be helpfull to me : /usr/share/texmf/doc/context/base/examplap/gui/letter.pdf. It seems to be a letter generator, but unfortunately I wasn't able to make it work. Maybe it is outdated since it is 10 years old.

The wiki has a page for examples and you’re free to update the existing examples or add new ones.

Do you mean http://wiki.contextgarden.net/Sample_documents ? Yes, that's a good idea, since I believe that it is a way to improve documentation with little efforts. Then I plan to add the cover letter style I made since I am happy with the results, although 1 or 2 things could have some improvement. There are also some letter styles there, then I will have a look on them too. I don't know if people are intimidated about writing contents in the wiki because it is the official wiki and feel that only programmers are supposed to update it, but it will be really helpfull if the users have more the habit of posting there the document styles they made.

Sounds interesting and the best thing you can do is to start with it.

Thanks for your encouragement ! Yes that looks like an interesting challenge for me, but it is not something I am wanting to do alone because of my lack of experience, at least I would need someone to coach me. Actually I don't have really experience with web developpment and I would at least need help for the technological choices. Having someone that tells me that if I use technology X, there are module Y and Z that will be a good fit is a good start.

Have a nice day,
Jonas
--------------3EAB22CA6FC5B5EF772E8C13-- --===============0192928595498138526== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: base64 Content-Disposition: inline X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX18KSWYgeW91ciBxdWVzdGlvbiBpcyBvZiBpbnRlcmVz dCB0byBvdGhlcnMgYXMgd2VsbCwgcGxlYXNlIGFkZCBhbiBlbnRyeSB0byB0aGUgV2lraSEKCm1h aWxsaXN0IDogbnRnLWNvbnRleHRAbnRnLm5sIC8gaHR0cDovL3d3dy5udGcubmwvbWFpbG1hbi9s aXN0aW5mby9udGctY29udGV4dAp3ZWJwYWdlICA6IGh0dHA6Ly93d3cucHJhZ21hLWFkZS5ubCAv IGh0dHA6Ly90ZXguYWFuaGV0Lm5ldAphcmNoaXZlICA6IGh0dHA6Ly9mb3VuZHJ5LnN1cGVsZWMu ZnIvcHJvamVjdHMvY29udGV4dHJldi8Kd2lraSAgICAgOiBodHRwOi8vY29udGV4dGdhcmRlbi5u ZXQKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX18= --===============0192928595498138526==--