RE: Lists in normative section

Gregg Vanderheiden writes:
 > 
 > Hi Lee, Jason
 > 
 > 
 > Jason, I agree that moving them to informative might lose them.
 > I think the phrasing you used though still sounds like a command or
 > recommendation.
 > How about make them into topics rather than recommendations
 > 
 > - sentence length and complexity
 > - number of ideas in sentences (1 is best)
 > - number of ideas in paragraphs (1 is best)
 > - use of jargon and other words that may not be familiar to readers of site.
 > 
 > Etc.

Interesting. My only reservation about this is that some of the above
aren't sufficiently explicit as to  what should be preferred. Try this:

Sentence length and complexity (shorter and less complex sentences are
easier to understand)
[quoting Gregg]
 > - number of ideas in sentences (1 is best)
 > - number of ideas in paragraphs (1 is best)

Avoidance of jargon likely to be unfamiliar to the intended audience

These are less ambiguous but still can't be readily misconstrued as
imperatives.

Thoughts?

Received on Friday, 17 January 2003 19:22:32 UTC