From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/56699 Path: news.gmane.org!not-for-mail From: James Fisher Newsgroups: gmane.comp.tex.context Subject: Re: Occasional words sticking out from flush-right Date: Thu, 4 Mar 2010 19:44:39 +0000 Message-ID: <771da05a1003041144y6fd1f9dboc21cd3debd4a60a5@mail.gmail.com> References: <4B8ED8F7.9010209@gmail.com> <20100303215354.GB2029@phare.normalesup.org> <771da05a1003031519w7803d7dcn9cb4c52be548ffec@mail.gmail.com> <771da05a1003031835m721cc2ccqb8832224b09c921@mail.gmail.com> <771da05a1003040625h57b76829r11dea4cb4c800a16@mail.gmail.com> Reply-To: mailing list for ConTeXt users NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="===============1538554564==" X-Trace: dough.gmane.org 1267736279 21745 80.91.229.12 (4 Mar 2010 20:57:59 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 4 Mar 2010 20:57:59 +0000 (UTC) To: mailing list for ConTeXt users Original-X-From: ntg-context-bounces@ntg.nl Thu Mar 04 21:57:53 2010 Return-path: Envelope-to: gctc-ntg-context-518@m.gmane.org Original-Received: from balder.ntg.nl ([195.12.62.10]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1NnH7U-0006o5-J3 for gctc-ntg-context-518@m.gmane.org; Thu, 04 Mar 2010 20:54:05 +0100 Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id 66D0FC9CB1; Thu, 4 Mar 2010 20:44:52 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at balder.ntg.nl Original-Received: from balder.ntg.nl ([127.0.0.1]) by localhost (balder.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with LMTP id D80LP6KUHSdj; Thu, 4 Mar 2010 20:44:47 +0100 (CET) Original-Received: from balder.ntg.nl (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id 74883C9C67; Thu, 4 Mar 2010 20:44:47 +0100 (CET) Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id 04C74C9C67 for ; Thu, 4 Mar 2010 20:44:46 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at balder.ntg.nl Original-Received: from balder.ntg.nl ([127.0.0.1]) by localhost (balder.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with LMTP id 2jah94-RpB+9 for ; Thu, 4 Mar 2010 20:44:42 +0100 (CET) Original-Received: from ey-out-1920.google.com (ey-out-1920.google.com [74.125.78.148]) by balder.ntg.nl (Postfix) with ESMTP id 930FDC9C12 for ; Thu, 4 Mar 2010 20:44:42 +0100 (CET) Original-Received: by ey-out-1920.google.com with SMTP id 13so522698eye.6 for ; Thu, 04 Mar 2010 11:44:42 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:in-reply-to:references :date:message-id:subject:from:to:content-type; bh=sZgyxUJMUF6eP8w6kZOS+C4axxEJVAPISSQZ6rMyNr0=; b=Tg4o4u5cvX55DZ4xnd7+Bez9/zSZj5Z8gjggIVsrcr8VgNOCQDI4ShCl13thr6EPlq 0ICpiCnYImqSDx0zpfMxFmWY6lnIi11SHgNPDWWGJ/2n//TUV5x6NDBV6HP80dzTsLoE mdGRaZ66TNqULIwreoIHIu8H12jbO4t7IzyGY= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type; b=PvsNoytvBWEVAN2gVyhKfHqoABU+rUoxXn0L33W5X/guhjWC+wwPpzzO5Z3grvO6bg BwLp5TYFsLNmf/I7wPb9GO/nfKf5RA1AV5wR7D/zZIsNWlze8kGBBuisaB2d2VHOBaz2 QeeslCsqQDt0zi2EVVBvTyszdpoKQZfllc84M= Original-Received: by 10.213.109.208 with SMTP id k16mr888564ebp.15.1267731879664; Thu, 04 Mar 2010 11:44:39 -0800 (PST) In-Reply-To: X-BeenThere: ntg-context@ntg.nl X-Mailman-Version: 2.1.12 Precedence: list List-Id: mailing list for ConTeXt users List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: ntg-context-bounces@ntg.nl Errors-To: ntg-context-bounces@ntg.nl Xref: news.gmane.org gmane.comp.tex.context:56699 Archived-At: --===============1538554564== Content-Type: multipart/alternative; boundary=000e0ce0b4a65b9e6e0480fed4fc --000e0ce0b4a65b9e6e0480fed4fc Content-Type: text/plain; charset=ISO-8859-1 Hi Luigi, On Thu, Mar 4, 2010 at 6:42 PM, luigi scarso wrote: > On Thu, Mar 4, 2010 at 3:25 PM, James Fisher > wrote: > > lol; I thought this might come up. I have a couple of replies to that: > > > > (1) First and most important: I'm not suggesting that we use TeX to > document > > things at all. I'm suggesting that ConTeXt documentation should be > > accessible to newcomers in the same format as 99% of all other projects: > > good old HTML. > Today HTML is still crude for a typographer but things can change with > WOFF. > You still can't show the potential of ConTeXt with HTML, because main > output is pdf . > > I completely understand that typographically, HTML is crude -- if it wasn't, I probably wouldn't be here at all; I'd write in HTML and print to PDF from a browser. But I think that's misunderstanding what 'the potential of ConTeXt' is. ConTeXt was not created to produce documentation for ConTeXt. People are not foolish enough to think, "if project X doesn't write its documentation in X, there can't be much else it can do". You don't write Teach Yourself French in the French language. (Also: WOFF will only help inasmuch as we can force quality typefaces on people (no improvements in e.g. line-breaking algorithms, microtypography, and what have you). But that's off the issue.) > >On the web (which you are), HTML is king. > On a printing house( which I'm) , PDF is the king. > > Ok, I said I'd put the HTML/PDF thing to rest, but I'll try and get my thoughts across again: I found ConTeXt via the web. Almost every single other software project I've ever found, I've found via the web. I did not find ConTeXt via a printing house (perhaps others do; I'm getting the impression I'm a bit of an outlier in this community). HTML is typographically crude, but, and this is important, *informationally*, HTML (and the web and friends) is far from crude. The web is not a vast flat collection of PDFs. It's the unchallenged superglue of the web, which is where I feel that the community should properly lie. Now, it's quite possible that other people disagree with me here, and that I'm factually wrong -- for example if the ConTeXt community predominantly lies in the 'real-world', with gatherings, seminars, with handed-out printed leaflets and manuals, with overhead slide presentations -- in *that* case, then yes, PDF is king. > >TeX and PDFs are > > no replacement for the interconnected power of the web. When I want a > quick > > piece of information in <10 seconds, I do not want to consult a > > hand-collected folder of PDFs, or google for it and wait the age for a > PDF > > to load. > I grep the code. > It works even offline and in less than 1 second. > > Yes. But the web works (albeit only while online, but who is ever offline?) in less than a second too, and the web is far more than a 'World Wide Grep'. It's an unimaginably vast cross-referenced semantically aware net with search engines of huge processing power. Executing `grep interpretation of grave character *' unfortunately does not give quite the same result. > > That kind of feeling, I guess, is the reason that the > > contextgarden wiki exists. But nor is Mediawiki is really not the most > > appropriate way to document a project. Wikis are messy and unstructured. > > They don't lend themselves well to the hierarchical kind of structure > > appropriate for representing a codebase. So I'm suggesting that ConTeXt > be > > documented using a typical established documentation system. > I disagree. > minimals should be self-cointained. > a documentation system not done in Context can introduce a useless > dependency. > > Anyway > even if there is already > http://foundry.supelec.fr/gf/project/modules/scmsvn/ > (which is only usefula as testbed, not for documentation) > > or if we will have something like cseq one day > (see > http://www.tug.org/utilities/plain/cseq.html, possible made in > automatic fashion from code base) > > This looks lovely. > > or a wiki book > (see > http://en.wikibooks.org/wiki/LaTeX > apropos of "Mediawiki is really not the most > appropriate way to document a project" ) > > it will be not enough --- a good starting point, of course. > > > In the end, one needs to understand the language, his semantic and > study the code. > With TeXBook, a couple of manuals from pragma (cont-en, metafun) and > the code you are ok > (well also ~1000 pages of pdf specs. are not bad and also some book > about fonts ...). > Mmm, yes, you've made quite a lot of demands there on the curious programmer having stumbled across ConTeXt ... > Others are articles, and they are ok too. > TeX is a macro language. There are almost ~1000 macros , and maybe > ~500 macros in ConTeXt. > Even if we are able to "documents" them in some manner, understanding > them and their relations > is a matter of study the code. > > I don't think so. The "just study the code" approach shows an awfully austere, reductionist philosophy. Humans understand things from the top down. It's the computers that work from the bottom up. > > >> About model of development: one developer is not so strange afterall . > > > > I'm not sure what your point is here. That user contribution leads to > > 'featuritis'? I totally understand that being 'frozen' is not a bad > thing; > > it effectively means 'having reached a state of perfection for the > defined > > task' -- I don't think this has a connection with having one developer. > > More developers == faster rate of approach to the limit of perfection. > > No, not necessarily and not in this situation. > For TeX frozen means no new features, only bugfixes; > it means that the language is maintained and backward compatibility is > very important. > (about 80% of scientific articles are in TeX, so backward > compatibility is really important) . > It doesn't mean that the language is perfect. > To me frozen simply says that "it's time to explore the semantic of > the language rather than > add new features" > > > > > >> > >> This model doesn't imply that you cannot contribute to the code base > >> but only that all contributions need to be validate (and possible > >> rejected) and integrate by developer,. > >> You can also contribute with third part modules, but they are not in > >> base code and in case of conflicts code base wins. > >> > > > > Sure thing -- revision control doesn't hinder that at all. If Hans > doesn't > > want to merge someone else's changes to his (authoritative) copy of the > > repo, then he doesn't have to. DVCS != chaos. > One developer assure that there is exactly one version e no forks > (friendly or not). > This is also ok because there is no need for forks (afterall none are > thinking to fork LaTeX2e): > I think you're thinking of 'forking' as something dangerous (yeah, the word sounds painful), as something that will fragment the community, as something that destroys the concept of 'authority'. It's really not. Where you get forking you get merging at roughly the same rate. > > If Hans doesn't > > want to merge someone else's changes to his (authoritative) copy of the > > repo, then > the changes are rejected from the code base. > > I'm not saying that a dcvs is useless for documentation or manuals. > But without contributors a dcvs can be practically useless, > and the only contributors for manuals actually are Taco for luatex and > Hans for Context mkiv. > > Why are they the only contributors? > > > > -- > luigi > > ___________________________________________________________________________________ > 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 > > ___________________________________________________________________________________ > --000e0ce0b4a65b9e6e0480fed4fc Content-Type: text/html; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Hi Luigi,

On Thu, Mar 4, 2010 at 6:42 PM,= luigi scarso <luigi.scarso@gmail.com> wrote:
On Thu, Mar 4, 2010 at 3:25 PM, James Fisher <jameshfisher@gmail.com> wrote: > lol; I thought this might come up.=A0 I have a couple of replies to th= at:
>
> (1) First and most important: I'm not suggesting that we use TeX t= o document
> things at all.=A0 I'm suggesting that ConTeXt documentation should= be
> accessible to newcomers in the same format as 99% of all other project= s:
> good old HTML.
Today HTML is still crude for a typographer but things can change wit= h WOFF.
You still can't show the potential of ConTeXt =A0with HTML, because mai= n
output is pdf .


I completely understand t= hat typographically, HTML is crude -- if it wasn't, I probably wouldn't be here at all; I'd write in HTML a= nd print to PDF from a browser. But I think that's misunderstanding what 'th= e potential of ConTeXt' is.=A0 ConTeXt was not created to produce docum= entation for ConTeXt.=A0 People are not foolish enough to think, "if p= roject X doesn't write its documentation in X, there can't be much = else it can do".=A0 You don't write Teach Yourself French in the F= rench language.

(Also: WOFF will only help inasmuch as we can force quality typefaces o= n people (no improvements in e.g. line-breaking algorithms, microtypography= , and what have you).=A0 But that's off the issue.)
=A0
>On the web (which you are), HTML is king.
On a printing house( which I'm) , PDF is the king.


Ok, I said I'd put th= e HTML/PDF thing to rest, but I'll try and get my thoughts across again= :
I found ConTeXt via the web.=A0 Almost every single other software pro= ject I've ever found, I've found via the web.=A0 I did not find Con= TeXt via a printing house (perhaps others do; I'm getting the impressio= n I'm a bit of an outlier in this community).=A0 HTML is typographicall= y crude, but, and this is important, *informationally*, HTML (and the web a= nd friends) is far from crude.=A0 The web is not a vast flat collection of = PDFs.=A0 It's the unchallenged superglue of the web, which is where I f= eel that the community should properly lie.=A0 Now, it's quite possible= that other people disagree with me here, and that I'm factually wrong = -- for example if the ConTeXt community predominantly lies in the 'real= -world', with gatherings, seminars, with handed-out printed leaflets an= d manuals, with overhead slide presentations -- in *that* case, then yes, P= DF is king.
=A0
>TeX and PDFs are
> no replacement for the interconnected power of the web.=A0 When I want= a quick
> piece of information in <10 seconds, I do not want to consult a
> hand-collected folder of PDFs, or google for it and wait the age for a= PDF
> to load.
I grep the code.
It works even offline and in less than 1 second.


Yes. But the web works (a= lbeit only while online, but who is ever offline?) in less than a second to= o, and the web is far more than a 'World Wide Grep'.=A0 It's an= unimaginably vast cross-referenced semantically aware net with search engi= nes of huge processing power.=A0 Executing `grep interpretation of grave ch= aracter *' unfortunately does not give quite the same result.
=A0
> That kind of feeling, I guess, is the reason that the
> contextgarden wiki exists.=A0 But nor is Mediawiki is really not the m= ost
> appropriate way to document a project.=A0 Wikis are messy and unstruct= ured.
> They don't lend themselves well to the hierarchical kind of struct= ure
> appropriate for representing a codebase.=A0 So I'm suggesting that= ConTeXt be
> documented using a typical established documentation system.
I disagree.
minimals should be self-cointained.
a documentation system not done in =A0Context can introduce a useless depen= dency.

Anyway
even if there is already
http://foundry.supelec.fr/gf/project/modules/scmsvn/
(which is only usefula as testbed, not for documentation)

or if we will have something like cseq one day
(see
= http://www.tug.org/utilities/plain/cseq.html, possible made in
automatic fashion from code base)


This looks lovely.
=A0

or a wiki book
(see
http://en.= wikibooks.org/wiki/LaTeX
apropos of "Mediawiki is really not the most
appropriate way to document a project" )

it will be not enough --- a good starting point, of course.


In the end, one needs to understand the language, his semantic and
study the code.
With TeXBook, a couple of manuals from pragma (cont-en, metafun) and
the code you are ok
(well also ~1000 pages of pdf specs. are not bad and also =A0some book
about fonts ...).

Mmm, yes, you've made quite = a lot of demands there on the curious programmer having stumbled across Con= TeXt ...
=A0
Others are articles, and they are ok too.
TeX is a macro language. There are almost ~1000 macros , and maybe
~500 macros in ConTeXt.
Even if we are able to "documents" them in some manner, understan= ding
them and their relations
is a matter of study the code.


I don't think so.=A0 = The "just study the code" approach shows an awfully austere, redu= ctionist philosophy.=A0 Humans understand things from the top down.=A0 It&#= 39;s the computers that work from the bottom up.
=A0

>> About model of development: one developer is not so strange aftera= ll .
>
> I'm not sure what your point is here.=A0 T= hat user contribution leads to
> 'featuritis'?=A0 I totally understand that being 'frozen&#= 39; is not a bad thing;
> it effectively means 'having reached a state of perfection for the= defined
> task' -- I don't think this has a connection with having one d= eveloper.
> More developers =3D=3D faster rate of approach to the limit of perfect= ion.

No, not necessarily and not in this situation.
For TeX frozen =A0means no new features, only =A0bugfixes;
it means that the language is maintained and backward compatibility is
very important.
(about 80% of scientific articles are in TeX, so backward
compatibility is really important) .
It doesn't mean that the language is perfect.
To me frozen simply says that "it's time to explore the semantic o= f
the language rather than
add new =A0features"


>
>>
>> This model doesn't imply that you cannot contribute to the cod= e base
>> but only that all contributions need to be =A0validate (and possib= le
>> rejected) and integrate by developer,.
>> You can also contribute with third part modules, but they are not = in
>> base code and in case of conflicts code base wins.
>>
>
> Sure thing -- revision control doesn't hinder that at all.=A0 If H= ans doesn't
> want to merge someone else's changes to his (authoritative) copy o= f the
> repo, then he doesn't have to.=A0 DVCS !=3D chaos.
One developer assure that there is exactly one version e no forks
(friendly or not).
This is also ok because there is no need for forks (afterall none are
thinking to fork LaTeX2e):

I think you're thin= king of 'forking' as something dangerous (yeah, the word sounds pai= nful), as something that will fragment the community, as something that des= troys the concept of 'authority'.=A0 It's really not.=A0 Where = you get forking you get merging at roughly the same rate.
=A0
> If Hans doesn't
> want to merge someone else's changes to his (authoritative) copy o= f the
> repo, then
the changes are rejected from the code base.

I'm not saying that a dcvs is useless for documentation or manuals.
But without contributors a dcvs can be practically useless,
and the only contributors for manuals actually are Taco for luatex and
Hans for Context mkiv.


Why are they the o= nly contributors?
=A0



--
luigi
___________________________________________________________________________= ________
If your question is of interest to others as well, please add an entry to t= he Wiki!

maillist : ntg-context@ntg.nl / <= a href=3D"http://www.ntg.nl/mailman/listinfo/ntg-context" target=3D"_blank"= >http://www.ntg.nl/mailman/listinfo/ntg-context
webpage =A0: http://= www.pragma-ade.nl / http://tex.aanhet.net
archive =A0: http://foundry.supelec.fr/projects/contextrev/
wiki =A0 =A0 : http:= //contextgarden.net
___________________________________________________________________________= ________

--000e0ce0b4a65b9e6e0480fed4fc-- --===============1538554564== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline ___________________________________________________________________________________ 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 ___________________________________________________________________________________ --===============1538554564==--