Re: Documentation and abbreviations

2002-07-14 Thread Steven Noels
Nicola Ken Barozzi wrote: Even better, we make a link creating Transformer that transforms all instances of xsp to a link that links to a cocoon terms dictionary. *All* instances? Hm. Wouldn't that be troublesome to read? Reminds me of Wiki webs where people where triggerhappy with

Re: Documentation and abbreviations

2002-07-14 Thread Andrew C. Oliver
Steven Noels wrote: *All* instances? Hm. Wouldn't that be troublesome to read? Reminds me of Wiki webs where people where triggerhappy with hyperreferences. A thesaurus of some sorts, easily reachable from each page, might perhaps already be enough. /Steven Here is my first entry :-)

Re: Documentation and abbreviations

2002-07-14 Thread Steven Noels
Andrew C. Oliver wrote: Here is my first entry :-) glossary entry phraseCocoon Syndrome/phrase meaningThe tendancy whenever anything regarding documentation to focus on a tool for doing the documentation function than actually producing content.

Re: Documentation and abbreviations

2002-07-14 Thread Andrew C. Oliver
Steven Noels wrote: Andrew C. Oliver wrote: Here is my first entry :-) glossary entry phraseCocoon Syndrome/phrase meaningThe tendancy whenever anything regarding documentation to focus on a tool for doing the documentation function than actually

Re: Documentation and abbreviations

2002-07-14 Thread Nicola Ken Barozzi
Andrew C. Oliver wrote: Steven Noels wrote: *All* instances? Hm. Wouldn't that be troublesome to read? Reminds me of Wiki webs where people where triggerhappy with hyperreferences. A thesaurus of some sorts, easily reachable from each page, might perhaps already be enough. /Steven

Re: Documentation and abbreviations

2002-07-14 Thread Andrew C. Oliver
Nicola Ken Barozzi wrote: Andrew C. Oliver wrote: Steven Noels wrote: *All* instances? Hm. Wouldn't that be troublesome to read? Reminds me of Wiki webs where people where triggerhappy with hyperreferences. A thesaurus of some sorts, easily reachable from each page, might perhaps

Re: Documentation and abbreviations

2002-07-13 Thread Bert Van Kets
At 15:32 12/07/2002 -0500, you wrote: Bert Van Kets wrote: this is a great idea if implemented properly. I hate being moved to a new page just clicking on a link on an abbreviation. I see different implementations 1. a link to a footnote on the same place where the abbreviation is explained.

Documentation and abbreviations

2002-07-12 Thread Andrew C. Oliver
Hi All, this is mostly a pedantic issue. But one thing that bugs me about much of the existing cocoon documentation is the style in which Cocoon-specific abbreviations are used. A good example: http://xml.apache.org/cocoon/userdocs/xsp/index.html The most basic question is What does XSP

RE: Documentation and abbreviations

2002-07-12 Thread Piroumian Konstantin
Having a glossary of terms would be also fine. We should think about it on Forrest. (I could provide a sample, but it's in Russian). Konstantin From: Andrew C. Oliver [mailto:[EMAIL PROTECTED]] Hi All, this is mostly a pedantic issue. But one thing that bugs me about much of the

Re: Documentation and abbreviations

2002-07-12 Thread Nicola Ken Barozzi
Andrew C. Oliver wrote: Hi All, this is mostly a pedantic issue. But one thing that bugs me about much of the existing cocoon documentation is the style in which Cocoon-specific abbreviations are used. A good example: http://xml.apache.org/cocoon/userdocs/xsp/index.html The most

Re: Documentation and abbreviations

2002-07-12 Thread Bert Van Kets
At 16:19 12/07/2002 +0200, you wrote: Andrew C. Oliver wrote: Hi All, this is mostly a pedantic issue. But one thing that bugs me about much of the existing cocoon documentation is the style in which Cocoon-specific abbreviations are used. A good example:

Re: Documentation and abbreviations

2002-07-12 Thread Tony Collen
Bert Van Kets wrote: this is a great idea if implemented properly. I hate being moved to a new page just clicking on a link on an abbreviation. I see different implementations 1. a link to a footnote on the same place where the abbreviation is explained. At least the user would stay on

RE: Documentation and abbreviations

2002-07-12 Thread Vadim Gritsenko
From: Bert Van Kets [mailto:[EMAIL PROTECTED]] At 16:19 12/07/2002 +0200, you wrote: Andrew C. Oliver wrote: Hi All, this is mostly a pedantic issue. But one thing that bugs me about much of the existing cocoon documentation is the style in which Cocoon-specific abbreviations are used.