You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@cocoon.apache.org by Bertrand Delacretaz <bd...@codeconsult.ch> on 2002/11/21 17:40:36 UTC
Re: Documentation Format... (better names than manpages)
On Thursday 21 November 2002 17:20, Andy Lewis wrote:
>. . .
> User Reference Pages
> Developer Reference Pages
+1
-Bertrand
Re: Documentation Format... (better names than manpages)
Posted by Andy Lewis <aj...@ascii27.net>.
>
> On Thursday, November 21, 2002, at 11:40 AM, Bertrand Delacretaz wrote:
>
>> On Thursday 21 November 2002 17:20, Andy Lewis wrote:
>>> . . .
>>> User Reference Pages
>>> Developer Reference Pages
>>
>> +1
>
> This is fine with me. However, let's be consistent about URI space. Instead of
>
> xxx-manpage.xml
> xxx-userref.xml
> xxx-devref.xml
>
> didn't we decide previously [1] (with your valuable input, Bertrand) on
>
> userref-xxx.xml
> devref-xxx.xml
>
> So a full URI might be:
>
> xml.apache.org/cocoon/userref/userref-xxx.html
> xml.apache.org/cocooon/devref/devref-xxx.html
>
> This would be consistent with what we have already implemented with faqs, how-tos, tutorials,
> etc.
+1
>
> Diana
>
> [1] http://marc.theaimsgroup.com/?l=forrest-dev&m=102053149908865&w=2
--
"The heights of genius are only measurable by the depths of stupidity."
Re: Documentation Format... (better names than manpages)
Posted by Bertrand Delacretaz <bd...@codeconsult.ch>.
On Friday 22 November 2002 11:49, Diana Shannon wrote:
>. . .
> didn't we decide previously [1] (with your valuable input, Bertrand) on
>
> userref-xxx.xml
> devref-xxx.xml
>. . .
Well, at my old-fartish age one tends to forget ;-)
+1 of course.
I think we could start summarizing (at the wiki) this cool "user reference
pages" spec. I won't have time in the next few days (and I have yet to try
the HowToForrestTransition) but if someone feels like doing it...
-Bertrand
Re: Documentation Format... (better names than manpages)
Posted by Diana Shannon <sh...@apache.org>.
On Thursday, November 21, 2002, at 11:40 AM, Bertrand Delacretaz wrote:
> On Thursday 21 November 2002 17:20, Andy Lewis wrote:
>> . . .
>> User Reference Pages
>> Developer Reference Pages
>
> +1
This is fine with me. However, let's be consistent about URI space.
Instead of
xxx-manpage.xml
xxx-userref.xml
xxx-devref.xml
didn't we decide previously [1] (with your valuable input, Bertrand) on
userref-xxx.xml
devref-xxx.xml
So a full URI might be:
xml.apache.org/cocoon/userref/userref-xxx.html
xml.apache.org/cocooon/devref/devref-xxx.html
This would be consistent with what we have already implemented with
faqs, how-tos, tutorials, etc.
Diana
[1] http://marc.theaimsgroup.com/?l=forrest-dev&m=102053149908865&w=2