You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@cocoon.apache.org by Andreas Hochsteger <e9...@student.tuwien.ac.at> on 2002/05/10 22:16:46 UTC
[DOC] Cocoon Related Resources (attached)
Hi!
I finally managed to get my text-only listing of cocoon related resources
converted to the document XML format. All files are located in the directory
src/documentation/xdocs/links.
I chose the following structure, all reachable via the menu entry Links:
* Main (../index.xml)
* Overview (index.xml)
Resources:
* Tips and Guides (tips_guides.xml
* Books (books.xml)
* Training (training.xml)
Sites:
* Cocoon Sites (sites.xml)
* Projects (projects.xml)
* Live Sites (livesites.xml)
* Cocoon Hosting (hosting.xml)
Related Links:
* XML (xml.xml)
* XSL/XSLT (xsl.xml)
I've attached the file xdocs.tar.gz which contains a modified book.xml
(original file was just checked out) for the main menu and the directory
links with all the other files. Simply replace
src/documentation/xdocs/book.xml with the one in the attachment and copy the
directory links to src/documentation/xdocs/. Now you should see the new menu
entry.
I moved the menu entries 'Live Sites', 'Cocoon Hosting' and 'XML Links' to the
new directory and split the links from the menu entry 'Cocoon Links' into the
link categories where the fit now.
I'd be happy for your feedback, especially the wording of the menu entries
(which I'm not yet very happy with in some cases).
--
Bye,
Andreas
Re: [DOC] Cocoon Related Resources (attached)
Posted by Andreas Hochsteger <e9...@student.tuwien.ac.at>.
Hi!
On Samstag, 11. Mai 2002 13:47, Diana Shannon wrote:
> Andreas,
>
> > I'm just exending the 'Other Topics' section and added a page for
> > DTD/XML
> > Schema links and want to continue to provide some links to references,
> > guides, articles, ... to technologies and standards used by cocoon.
>
> That sounds great.
>
> > If I can help you somewhere else, you can point me there. I'll see, if
> > I find
> > enough time to help you out.
>
> Don't think of it as helping *me* out -- it's about giving back to the
> community for this great software we all can use for free. We're all
> volunteers, just doing the best we can. Individuals come and go, but the
> community as a whole goes on, I guess, as long as the software remains
> relevant, and we all continue to have *fun* participating.
>
> > Is there somewhere an official document on how to contribute
> > documentation for
> > cocoon?
>
> Not yet. It has been delayed by the lack of a clear consensus on
> cocoon-dev. Right now, the only "official" way is the path you have
> already followed. I'm really sorry about this.
>
> > I had some difficulties (how to use bugzilla in case of docs) at the
> > beginning
> > on delivering my work.
>
> Well, now that you have been through it, you are the *perfect* person to
> write a howto document on how to contribute docs through bugzilla. You
> perspective is "fresh," and I think you will be able to anticipate the
> difficulties new users will have. Your howto will save some trouble for
> other people who may decide to contribute in the future. I'll post an
> announcement to this list when instructions and resources to contribute
> specific docs, like howtos and others, are available for you to
> download. Thanks for your interest and help so far.
I'll see what I can do ...
Therefore I've got some more questions which I'll post in a separate thread.
> Diana
Thanks,
Andreas
---------------------------------------------------------------------
Please check that your question has not already been answered in the
FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
To unsubscribe, e-mail: <co...@xml.apache.org>
For additional commands, e-mail: <co...@xml.apache.org>
Re: [DOC] Cocoon Related Resources (attached)
Posted by Diana Shannon <te...@mac.com>.
Andreas,
> I'm just exending the 'Other Topics' section and added a page for
> DTD/XML
> Schema links and want to continue to provide some links to references,
> guides, articles, ... to technologies and standards used by cocoon.
That sounds great.
> If I can help you somewhere else, you can point me there. I'll see, if
> I find
> enough time to help you out.
Don't think of it as helping *me* out -- it's about giving back to the
community for this great software we all can use for free. We're all
volunteers, just doing the best we can. Individuals come and go, but the
community as a whole goes on, I guess, as long as the software remains
relevant, and we all continue to have *fun* participating.
> Is there somewhere an official document on how to contribute
> documentation for
> cocoon?
Not yet. It has been delayed by the lack of a clear consensus on
cocoon-dev. Right now, the only "official" way is the path you have
already followed. I'm really sorry about this.
> I had some difficulties (how to use bugzilla in case of docs) at the
> beginning
> on delivering my work.
Well, now that you have been through it, you are the *perfect* person to
write a howto document on how to contribute docs through bugzilla. You
perspective is "fresh," and I think you will be able to anticipate the
difficulties new users will have. Your howto will save some trouble for
other people who may decide to contribute in the future. I'll post an
announcement to this list when instructions and resources to contribute
specific docs, like howtos and others, are available for you to
download. Thanks for your interest and help so far.
Diana
---------------------------------------------------------------------
Please check that your question has not already been answered in the
FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
To unsubscribe, e-mail: <co...@xml.apache.org>
For additional commands, e-mail: <co...@xml.apache.org>
Re: [DOC] Cocoon Related Resources (attached)
Posted by Andreas Hochsteger <e9...@student.tuwien.ac.at>.
Hi!
On Samstag, 11. Mai 2002 1:01, Diana Shannon wrote:
> Andreas,
>
> They came through fine. Good job.
Nice to hear.
> Thanks a lot!
No problem.
> Diana
>
>
> P.S. Want to do more? ;)
I'm just exending the 'Other Topics' section and added a page for DTD/XML
Schema links and want to continue to provide some links to references,
guides, articles, ... to technologies and standards used by cocoon.
If I can help you somewhere else, you can point me there. I'll see, if I find
enough time to help you out.
Is there somewhere an official document on how to contribute documentation for
cocoon?
I had some difficulties (how to use bugzilla in case of docs) at the beginning
on delivering my work.
I really would like to know how contribution works best.
--
Bye,
Andreas
---------------------------------------------------------------------
Please check that your question has not already been answered in the
FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
To unsubscribe, e-mail: <co...@xml.apache.org>
For additional commands, e-mail: <co...@xml.apache.org>
Re: [DOC] Cocoon Related Resources (attached)
Posted by Diana Shannon <sh...@terracare.com>.
Andreas,
They came through fine. Good job.
Thanks a lot!
Diana
P.S. Want to do more? ;)
On Friday, May 10, 2002, at 04:38 PM, Andreas Hochsteger wrote:
> Hi!
>
> On Freitag, 10. Mai 2002 22:23, Andrew C. Oliver wrote:
>> I think these changes should follow the same procedure as patches. Put
>> in bugzilla and attach the files rather than send them to the list.
>> (save the bug, go back to the bug and attach, use [PATCH] in the
>> subject)
>
> Sorry for doing it wrong, but I only did what has been suggested to me
> some
> days ago.
> Anyway I created a bug report in bugzilla
> (http://nagoya.apache.org/bugzilla/show_bug.cgi?id=8989) as you
> described. I
> hope that I've done everything right, since it was the first time I used
> bugzilla (shame on me ;-).
>
>> -Andy
>>
>> Andreas Hochsteger wrote:
>>> Hi!
>>>
>>> I finally managed to get my text-only listing of cocoon related
>>> resources
>>> converted to the document XML format. All files are located in the
>>> directory src/documentation/xdocs/links.
>>>
>>> I chose the following structure, all reachable via the menu entry
>>> Links:
>>>
>>> * Main (../index.xml)
>>> * Overview (index.xml)
>>>
>>> Resources:
>>> * Tips and Guides (tips_guides.xml
>>> * Books (books.xml)
>>> * Training (training.xml)
>>>
>>> Sites:
>>> * Cocoon Sites (sites.xml)
>>> * Projects (projects.xml)
>>> * Live Sites (livesites.xml)
>>> * Cocoon Hosting (hosting.xml)
>>>
>>> Related Links:
>>> * XML (xml.xml)
>>> * XSL/XSLT (xsl.xml)
>>>
>>> I've attached the file xdocs.tar.gz which contains a modified book.xml
>>> (original file was just checked out) for the main menu and the
>>> directory
>>> links with all the other files. Simply replace
>>> src/documentation/xdocs/book.xml with the one in the attachment and
>>> copy
>>> the directory links to src/documentation/xdocs/. Now you should see
>>> the
>>> new menu entry.
>>> I moved the menu entries 'Live Sites', 'Cocoon Hosting' and 'XML
>>> Links' to
>>> the new directory and split the links from the menu entry 'Cocoon
>>> Links'
>>> into the link categories where the fit now.
>>>
>>> I'd be happy for your feedback, especially the wording of the menu
>>> entries
>>> (which I'm not yet very happy with in some cases).
>>>
>>>
>>>
>>> ------------------------------------------------------------------------
>>>
>>> ---------------------------------------------------------------------
>>> Please check that your question has not already been answered in the
>>> FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
>>>
>>> To unsubscribe, e-mail: <co...@xml.apache.org>
>>> For additional commands, e-mail: <co...@xml.apache.org>
>>
>> ---------------------------------------------------------------------
>> Please check that your question has not already been answered in the
>> FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
>>
>> To unsubscribe, e-mail: <co...@xml.apache.org>
>> For additional commands, e-mail: <co...@xml.apache.org>
>
> --
> Bye,
> Andreas
>
>
> ---------------------------------------------------------------------
> Please check that your question has not already been answered in the
> FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
>
> To unsubscribe, e-mail: <co...@xml.apache.org>
> For additional commands, e-mail: <co...@xml.apache.org>
>
---------------------------------------------------------------------
Please check that your question has not already been answered in the
FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
To unsubscribe, e-mail: <co...@xml.apache.org>
For additional commands, e-mail: <co...@xml.apache.org>
Re: [DOC] Cocoon Related Resources (attached)
Posted by Andreas Hochsteger <e9...@student.tuwien.ac.at>.
Hi!
On Freitag, 10. Mai 2002 22:23, Andrew C. Oliver wrote:
> I think these changes should follow the same procedure as patches. Put
> in bugzilla and attach the files rather than send them to the list.
> (save the bug, go back to the bug and attach, use [PATCH] in the subject)
Sorry for doing it wrong, but I only did what has been suggested to me some
days ago.
Anyway I created a bug report in bugzilla
(http://nagoya.apache.org/bugzilla/show_bug.cgi?id=8989) as you described. I
hope that I've done everything right, since it was the first time I used
bugzilla (shame on me ;-).
> -Andy
>
> Andreas Hochsteger wrote:
> >Hi!
> >
> >I finally managed to get my text-only listing of cocoon related resources
> >converted to the document XML format. All files are located in the
> > directory src/documentation/xdocs/links.
> >
> >I chose the following structure, all reachable via the menu entry Links:
> >
> >* Main (../index.xml)
> >* Overview (index.xml)
> >
> >Resources:
> >* Tips and Guides (tips_guides.xml
> >* Books (books.xml)
> >* Training (training.xml)
> >
> >Sites:
> >* Cocoon Sites (sites.xml)
> >* Projects (projects.xml)
> >* Live Sites (livesites.xml)
> >* Cocoon Hosting (hosting.xml)
> >
> >Related Links:
> >* XML (xml.xml)
> >* XSL/XSLT (xsl.xml)
> >
> >I've attached the file xdocs.tar.gz which contains a modified book.xml
> >(original file was just checked out) for the main menu and the directory
> >links with all the other files. Simply replace
> >src/documentation/xdocs/book.xml with the one in the attachment and copy
> > the directory links to src/documentation/xdocs/. Now you should see the
> > new menu entry.
> >I moved the menu entries 'Live Sites', 'Cocoon Hosting' and 'XML Links' to
> > the new directory and split the links from the menu entry 'Cocoon Links'
> > into the link categories where the fit now.
> >
> >I'd be happy for your feedback, especially the wording of the menu entries
> >(which I'm not yet very happy with in some cases).
> >
> >
> >
> >------------------------------------------------------------------------
> >
> >---------------------------------------------------------------------
> >Please check that your question has not already been answered in the
> >FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
> >
> >To unsubscribe, e-mail: <co...@xml.apache.org>
> >For additional commands, e-mail: <co...@xml.apache.org>
>
> ---------------------------------------------------------------------
> Please check that your question has not already been answered in the
> FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
>
> To unsubscribe, e-mail: <co...@xml.apache.org>
> For additional commands, e-mail: <co...@xml.apache.org>
--
Bye,
Andreas
---------------------------------------------------------------------
Please check that your question has not already been answered in the
FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
To unsubscribe, e-mail: <co...@xml.apache.org>
For additional commands, e-mail: <co...@xml.apache.org>
Re: [DOC] Cocoon Related Resources (attached)
Posted by "Andrew C. Oliver" <ac...@apache.org>.
I think these changes should follow the same procedure as patches. Put
in bugzilla and attach the files rather than send them to the list.
(save the bug, go back to the bug and attach, use [PATCH] in the subject)
-Andy
Andreas Hochsteger wrote:
>Hi!
>
>I finally managed to get my text-only listing of cocoon related resources
>converted to the document XML format. All files are located in the directory
>src/documentation/xdocs/links.
>
>I chose the following structure, all reachable via the menu entry Links:
>
>* Main (../index.xml)
>* Overview (index.xml)
>
>Resources:
>* Tips and Guides (tips_guides.xml
>* Books (books.xml)
>* Training (training.xml)
>
>Sites:
>* Cocoon Sites (sites.xml)
>* Projects (projects.xml)
>* Live Sites (livesites.xml)
>* Cocoon Hosting (hosting.xml)
>
>Related Links:
>* XML (xml.xml)
>* XSL/XSLT (xsl.xml)
>
>I've attached the file xdocs.tar.gz which contains a modified book.xml
>(original file was just checked out) for the main menu and the directory
>links with all the other files. Simply replace
>src/documentation/xdocs/book.xml with the one in the attachment and copy the
>directory links to src/documentation/xdocs/. Now you should see the new menu
>entry.
>I moved the menu entries 'Live Sites', 'Cocoon Hosting' and 'XML Links' to the
>new directory and split the links from the menu entry 'Cocoon Links' into the
>link categories where the fit now.
>
>I'd be happy for your feedback, especially the wording of the menu entries
>(which I'm not yet very happy with in some cases).
>
>
>
>------------------------------------------------------------------------
>
>---------------------------------------------------------------------
>Please check that your question has not already been answered in the
>FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
>
>To unsubscribe, e-mail: <co...@xml.apache.org>
>For additional commands, e-mail: <co...@xml.apache.org>
>
---------------------------------------------------------------------
Please check that your question has not already been answered in the
FAQ before posting. <http://xml.apache.org/cocoon/faqs.html>
To unsubscribe, e-mail: <co...@xml.apache.org>
For additional commands, e-mail: <co...@xml.apache.org>