Re: Citing HTML tags in docs?

Subject: Re: Citing HTML tags in docs?
From: Linda Sherman <linsherm -at- GTE -dot- NET>
Date: Tue, 10 Nov 1998 21:17:00 -0500

Geoff Hart (by way of \"Eric J. Ray\" ) wrote:
> Susan Kocher asked for advice on referring to HTML tags in
> documentation:
> <<The question arises, should we use uppercase in naming tags and
> attributes Lower case? Should tag names have angle brackets around
> them when we refer to them in paragraph text?>>
> If it's an instructional book, don't create any distance between the
> reader and the concept by making the citation in the text look
> different from the citation in the code: that requires extra skull
> sweat.

That's nice in theory, but in practice, HTML text-based editors are
becoming increasingly sophisticated about formatting tags and attributes
on the fly, so what it looks like in the text file isn't necessarily
what the coder sees on the screen--or winds up saving back to disk when

I would recommend using upper case in documentation, as that's what
nearly everyone else does (check out "how to code HTML" books at any
bookstore). Any HTML coder who gets confused between <A> and <a>
shouldn't be touching the stuff anyway.

Linda K. Sherman <linsherm -at- gte -dot- net>
Freelance Writer: Technical - Business - Government

From ??? -at- ??? Sun Jan 00 00:00:00 0000=

Previous by Author: Re: Code Documentation
Next by Author: Re: Your Opinion Please - Lecture Structure
Previous by Thread: Citing HTML tags in docs?
Next by Thread: Summary: Font Suggestions

What this post helpful? Share it with friends and colleagues:

Sponsored Ads