I mentioned on comp.text.tex that my copy of _Context The Mamual_ was a) tattered from use b) annotated here and there with corrections based on posts from this list. Another party wanted to borrow my manual! I sent him my two marginal annotations and redirected his attention to pragma-ade but his request gave me an idea. Perhaps we all should exchange annotations where there is a typo or other error we have uncovered. It would be a kind of group errata sheet. To start the ball rolling here are my two annotations: ------------------------------------------------------------ p 148:change "head=nomarking" to "header=nomarking" p 242: Modify example by adding opening brace prior to \startcombination and closing brace after \stopombination: ... {\startcombination ... \stopcombination} ------------------------------------------------------------ Obviously there are features that are covered elsewhere or covered better elsewhere. That is not my immediate concern. If we can just pool our marginal corrections it would be of mutual benefit. I use the English language manual in letter size format. -- John Culleton Books with answers to marketing and publishing questions: http://wexfordpress.com/tex/shortlist.pdf Book coaches, consultants and packagers: http://wexfordpress.com/tex/packagers.pdf
Hi John,
uncovered. It would be a kind of group errata sheet. To start the ball rolling here are my two annotations:
Please put them on the wiki. This would be an ideal place to collect these things. Patrick -- ConTeXt wiki and more: http://contextgarden.net
On Thursday 01 September 2005 03:28 pm, Patrick Gundlach wrote:
Hi John,
uncovered. It would be a kind of group errata sheet. To start the ball rolling here are my two annotations:
Please put them on the wiki. This would be an ideal place to collect these things.
Patrick In theory, yes. as practical matter one must first learn the wiki conventions, then establish a page or something for errata, and then let people know where to look/post, and then...
I use a brute force method. On my computer I have all the Context mailing list posts in a folder starting with February 2, 2004. I can search on a keyword. If the subject in every case contains "errata" then it is easy to assemble a listing of the pertinent posts. Looking to the future, if I see a post with "errata" in the subject line I can inspect it and mark up my manual. At that point I don't need the particular post any more. If instead we are to use the wiki, then someone (not me) needs to explain the ins and outs of wikidom, create a page etc. as outlined in my first paragraph. -- John Culleton Books with answers to marketing and publishing questions: http://wexfordpress.com/tex/shortlist.pdf Book coaches, consultants and packagers: http://wexfordpress.com/tex/packagers.pdf
At 06:20 AM 9/1/2005, John R. Culleton wrote:
Looking to the future, if I see a post with "errata" in the subject line I can inspect it and mark up my manual. At that point I don't need the particular post any more.
If instead we are to use the wiki, then someone (not me) needs to explain the ins and outs of wikidom, create a page etc. as outlined in my first paragraph.
I have created a page for errata in the ConTeXt-EN manual, here: http://wiki.contextgarden.net/ConTeXtEN_Errata The relevant ins and outs of Wikidom should be fairly straightforward -- to add an erratum, click on the "edit" link at the top of the page, and then add your erratum in the edit window (at this point, you should be able to simply duplicate the formatting of an existing item, without needing to know anything else), and click submit. As you note, it's useful to post here about the errata one discovers, so that people know of them (and also so that they can be discussed -- perhaps an erratum is itself in error!). My suggestion would be to post everything here, and include a note as to whether it has or has not been added to the Wiki page. If it hasn't been added, someone will surely add it. The three errata mentioned in this thread are on the page; I'll go back and see what else I find in the archives. - Brooks P.S. I think there should be a page for Errata in general, linked from the front page of the Wiki. (Or, else, the "Bugs and Workarounds" page should be changed to be "Bugs, Workarounds, and Errata") However, I don't have access to the front page of the Wiki to change that; can someone who has access do that?
John R. Culleton wrote:
Perhaps we all should exchange annotations where there is a typo or other error we have uncovered. It would be a kind of group errata sheet.
Yes, this would be a very good idea - for example I bumped into the combination 'bug' so long ago that I'd already forgotten about it; but at a time I both knew that it existed and how to fix it, so it's kind of stupid that you had to stumble on the same problem. Here's a stupid one from the big manual in English; doesn't bother me, but would confuse a newcomer (and yes, I checked this one with the online version, it still exists): ------- on p. 241 every single example says \exernalfigure[blaa] instead of \externalfigure ^^^ -------- I think contextgarden/wiki seems like an ideal place where to put these (that way we also avoid duplicates). I'm not very familiar with the system and find it somewhat hard to navigate, but if somebody points me to the correct direction, I'll enter anything I find in the manuals... The beginner's manual has some 'interesting' errors, too, and I assume the Dutch versions have their problems too, so maybe a separate entry/page for each manual and language? Sometimes a simple typo causes lots of frustration, so I'm all for this suggestion! mari (...using ConteXt to write manuals, guaranteed to come with typos, sometimes in awkward places...)
participants (4)
-
Brooks Moses -
John R. Culleton -
Mari Voipio -
Patrick Gundlach