cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From giacomo <giac...@apache.org>
Subject Re: Documentation: short alternative to @docname@?
Date Sat, 27 Oct 2001 15:28:11 GMT
On Fri, 26 Oct 2001, Stefano Mazzocchi wrote:

> David Crossley wrote:
> >
> > Hold on to your hats everyone! Once we resolve this stuff then
> > let us add it to documentation/xdocs/IMPORTANT
> > There are some real good reasons for keeping some type of
> > term substitution. Here is my big one - consistent speling.
> > Hey, i seem to type "Coccon" often - we had best not let that
> > slip through to production. Entity replacement prevents it.
>
> Following this reasoning, we could "entitize" almost all currently
> mispelled words (I *always* mispell "environment" in "enviornment" due
> to slippery typing skills)... c'mon, I don't think we need to go that
> far.
>
> The vote is:  do you want to keep @doctitle@ or equivalent (entities,
> xslt transformation, whatever) or stick with pure text (like Cocoon,
> Apache Cocoon) where it makes sense.

Hey, guys, IIRC Gianugos question in the first place was:

	do I have to write the brand name 'Apache Cocoon' in every place
	or is it allowed to use a shorter term like 'Cocoon'

independant of having replacement/macro capability to achieve
consistency.

Giacomo

>
> This is *ONLY* for the term "Cocoon" and "Apache Cocoon" that are *NOT*
> expected to change. Stuff like @version@ and @years@ are not touched by
> this vote.
>
> I vote +1 to remove @doctitle@.
>
>


---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org


Mime
View raw message