* Toward an errata sheet.
@ 2005-09-01 11:19 John R. Culleton
2005-09-01 15:28 ` Patrick Gundlach
2005-09-01 15:41 ` Mari Voipio
0 siblings, 2 replies; 5+ messages in thread
From: John R. Culleton @ 2005-09-01 11:19 UTC (permalink / raw)
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
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Re: Toward an errata sheet.
2005-09-01 15:28 ` Patrick Gundlach
@ 2005-09-01 13:20 ` John R. Culleton
2005-09-03 0:06 ` Brooks Moses
0 siblings, 1 reply; 5+ messages in thread
From: John R. Culleton @ 2005-09-01 13:20 UTC (permalink / raw)
Cc: Patrick Gundlach
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
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Toward an errata sheet.
2005-09-01 11:19 Toward an errata sheet John R. Culleton
@ 2005-09-01 15:28 ` Patrick Gundlach
2005-09-01 13:20 ` John R. Culleton
2005-09-01 15:41 ` Mari Voipio
1 sibling, 1 reply; 5+ messages in thread
From: Patrick Gundlach @ 2005-09-01 15:28 UTC (permalink / raw)
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
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Toward an errata sheet.
2005-09-01 11:19 Toward an errata sheet John R. Culleton
2005-09-01 15:28 ` Patrick Gundlach
@ 2005-09-01 15:41 ` Mari Voipio
1 sibling, 0 replies; 5+ messages in thread
From: Mari Voipio @ 2005-09-01 15:41 UTC (permalink / raw)
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...)
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Re: Toward an errata sheet.
2005-09-01 13:20 ` John R. Culleton
@ 2005-09-03 0:06 ` Brooks Moses
0 siblings, 0 replies; 5+ messages in thread
From: Brooks Moses @ 2005-09-03 0:06 UTC (permalink / raw)
Cc: Patrick Gundlach
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?
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2005-09-03 0:06 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2005-09-01 11:19 Toward an errata sheet John R. Culleton
2005-09-01 15:28 ` Patrick Gundlach
2005-09-01 13:20 ` John R. Culleton
2005-09-03 0:06 ` Brooks Moses
2005-09-01 15:41 ` Mari Voipio
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).