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,

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.

Re: Documentation and abbreviations

2002-07-14 Thread Andrew C. Oliver
Steven Noels wrote: > Andrew C. Oliver wrote: > >> Here is my first entry :-) >> >> >> >> Cocoon Syndrome >>The tendancy whenever anything regarding >> documentation to focus on a tool for doing the documentation function >> than actually producing conte

Re: Documentation and abbreviations

2002-07-14 Thread Steven Noels
Andrew C. Oliver wrote: > Here is my first entry :-) > > > > Cocoon Syndrome >The tendancy whenever anything regarding documentation > to focus on a tool for doing the documentation function > than actually producing content. Generally > resulting in

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. > > Here is my first entry :-)

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-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 >>

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 abbrevia

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

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: >>http://xml.apache.org/cocoon

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

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

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 sta