On 09 Aug 2002, it is alleged that Gervase Markham sauntered in to
netscape.public.mozilla.documentation and loudly proclaimed:
> dwx wrote:
>> Variants of spelling (cancelled, color, etc.)
>> Where variant forms of a word or phrase exists, the most commonly
>> used form will be used.
>
> I disagree. The form used by the document author should be used, because
> both are as correct as each other.
>
> Gerv
I suspect that would depend on what kind of d11n. For developer d11n and
relata, I would be inclined to agree, since for the moment it is
considerably more important just to get the d11n in place, up-to-date, and
maintained. At the very least, if it's done, the burden of it should lie
elsewhere (that was part of the rationale behind having sr= (or some
equivalent) serve an editorial function WRT d11n).
(Brant: This is precisely why your idea is a non-starter. If you're going
to start doing things to make writing such d11n even more of a chore,
there's even /less/ of a chance that such d11n will be written, maintained,
&c, &c.)
However, I would suggest that for more public d11n (user docs, web-dev docs)
this should be a consideration; people might not take note of consistency,
but they will take note of inconsistency, either amongst or within docs.
dwx' suggestion is meaningless: For you and I (at least as far as where we
reside goes), 'colour' /is/ the 'most commonly used form'; for an American,
however, it would be 'color'. (Hmm . . . that should probably have read:
"color.")
Altho' I don't personally make use of it, I'd say that adopting American
conventions WRT spelling, pointing, and the like for user/web-dev docs is
likely to cause the fewest problems in the long run.
/b.
--
Mozilla end-user questions should be directed to:
snews://secnews.netscape.com:563/netscape.mozilla.user.general
snews://secnews.netscape.com:563/netscape.mozilla.user.win32
snews://secnews.netscape.com:563/netscape.mozilla.user.mac
snews://secnews.netscape.com:563/netscape.mozilla.user.unix
Note that you need to have SSL enabled and the port set to 563.
