in reply to What to do about grammatical errors in tutorials

I agree with Splinky here. Spelling and grammar are important, particularly so in a permanent document like a tutorial. I believe the tutorials should be "stand alone" documents, without the need for a trail of comments and corrections to make sense of them. The author of the tutorial should make the corrections within the actual tutorial itself.

This means some method of notifying a tutorial author of any errors (technical or gramattical) is needed.

Ken

  • Comment on RE: What to do about grammatical errors in tutorials

Replies are listed 'Best First'.
RE: RE: What to do about grammatical errors in tutorials
by gaggio (Friar) on Jul 05, 2000 at 17:51 UTC
    I don't know how hard it would be to add some kind of spell checker to parse a submission each time there is a new article, but it might be interesting: the basic framework is already there, since it is possible to edit and re-edit your article to make it "look good", usually by changing the HTML tags.

    So... If there is such a parser, I think it should not be too hard to show the words that might have errors by painting them in red (I am thinking that this should be something that only the author should be able to see, so maybe that it should be a new tag like <GRAM></GRAM>.

    Well, this is just an idea. I do think that grammar is important but it does not make things "unreadable". It just makes it look more perfect, which is something to consider because Monks are seeking/showing the "Truth" in their contributions.
[reply]

In Section Perl Monks Discussion