Re: [RT] Moving towards a new documentation system

2003-10-19 Thread Joerg Heinicke
Late, but ... On 12.10.2003 18:21, Stefano Mazzocchi wrote: ... but you are talking about news and articles, which are immutable things. our learning objects are not immutable. for example, I could change their title as I go. Maybe the title, but not the content in general/completely - as you

Re: [RT] Moving towards a new documentation system

2003-10-19 Thread Stefano Mazzocchi
On Sunday, Oct 19, 2003, at 19:54 Europe/Rome, Joerg Heinicke wrote: Remain the everlasting semantically meaningful names. Of course the URL should match the content. But if the content changes, so that it no longer matches, what's the sense of having still this page? Even if you use IDs and

Re: [RT] Moving towards a new documentation system

2003-10-19 Thread Joerg Heinicke
On 19.10.2003 21:07, Stefano Mazzocchi wrote: Remain the everlasting semantically meaningful names. Of course the URL should match the content. But if the content changes, so that it no longer matches, what's the sense of having still this page? Even if you use IDs and change the content

Re: [RT] Moving towards a new documentation system

2003-10-19 Thread Stefano Mazzocchi
On Sunday, Oct 19, 2003, at 22:32 Europe/Rome, Joerg Heinicke wrote: On 19.10.2003 21:07, Stefano Mazzocchi wrote: Remain the everlasting semantically meaningful names. Of course the URL should match the content. But if the content changes, so that it no longer matches, what's the sense of

RE: [RT] Moving towards a new documentation system

2003-10-19 Thread Robert Koberg
Hi, This is probably a minor and implementation detail but I when I see the examples of datatypes being giving I was wondering if you were taking into consideration of XML Schema datatypes (and therefore RNG datatypes, though I don't understand the desire of clearly object oriented-type people

Re: [RT] Moving towards a new documentation system

2003-10-19 Thread Stefano Mazzocchi
On Sunday, Oct 19, 2003, at 23:41 Europe/Rome, Robert Koberg wrote: Hi, This is probably a minor and implementation detail but I when I see the examples of datatypes being giving I was wondering if you were taking into consideration of XML Schema datatypes (and therefore RNG datatypes, though

Re: [RT] Moving towards a new documentation system

2003-10-13 Thread Bertrand Delacretaz
Le Samedi, 11 oct 2003, à 18:30 Europe/Zurich, Barzilai Spinak a écrit : Just for the sake of those of us who know less than you, Cocoon gods There are no Cocoon gods here - everyone is welcome to express their opinion in a respectful way. What is the advantage of using an all-numeric

Re: Forrest and the NDS (Re: [RT] Moving towards a new documentation system)

2003-10-13 Thread Bertrand Delacretaz
Le Dimanche, 12 oct 2003, à 12:40 Europe/Zurich, Stefano Mazzocchi a écrit : On Sunday, Oct 12, 2003, at 04:23 Europe/Rome, Jeff Turner wrote: ... :) Let's remember that there's hard reuse and soft reuse. Hard reuse means physically integrating with Forrest/Lenya. Soft reuse means reusing

Re: [RT] Moving towards a new documentation system

2003-10-12 Thread Joerg Heinicke
On 11.10.2003 18:10, Antonio Gallardo wrote: Yep. You are the master here. Hello Antonio, the above is wrong and I guess Stefano does also not want that it is seen so. This was also the reason for his withdrawal as PMC head. Stefano might be something like a technical leader with his mostly

Re: [RT] Moving towards a new documentation system

2003-10-12 Thread Joerg Heinicke
On 11.10.2003 17:19, Stefano Mazzocchi wrote: ...How about naming files like 3948494-some-descriptive-name-for-humans-here.xml It's like suggesting to have a BugID 39484-my-file-can't-be-found as the primary key of the bug table in mysql, just because people might want to edit bugs by hand

RE: [RT] Moving towards a new documentation system

2003-10-12 Thread Bruno Dumon
On Sat, 2003-10-11 at 20:53, Robert Koberg wrote: snip/ I currently call these in transformation using the document function. Recently, I have been playing around with a XincludeFilter that does this prior to transformation (I assume this is the route you would take :). It is just that it is

Re: [RT] Moving towards a new documentation system

2003-10-12 Thread Stefano Mazzocchi
On Saturday, Oct 11, 2003, at 19:54 Europe/Rome, Nicola Ken Barozzi wrote: Antonio Gallardo wrote: ... Based on lastest posts, I will like to see a fusion Lenya+Forrest. Is this posible or they are divorced. Synergy. What I want Forrest and Lenya to seek is syergy. Agreed 100%. Merging two

Re: Forrest and the NDS (Re: [RT] Moving towards a new documentation system)

2003-10-12 Thread Stefano Mazzocchi
On Sunday, Oct 12, 2003, at 04:23 Europe/Rome, Jeff Turner wrote: On Sat, Oct 11, 2003 at 03:17:48PM +0200, Stefano Mazzocchi wrote: On Saturday, Oct 11, 2003, at 14:25 Europe/Rome, Nicola Ken Barozzi wrote: Please don't forget Forrest. we are not. :) Let's remember that there's hard reuse and

Re: [RT] Moving towards a new documentation system

2003-10-12 Thread Stefano Mazzocchi
On Sunday, Oct 12, 2003, at 11:20 Europe/Rome, Joerg Heinicke wrote: On 11.10.2003 18:10, Antonio Gallardo wrote: Yep. You are the master here. Hello Antonio, the above is wrong and I guess Stefano does also not want that it is seen so. This was also the reason for his withdrawal as PMC head.

RE: [RT] Moving towards a new documentation system

2003-10-12 Thread Robert Koberg
Morning, -Original Message- From: news [mailto:[EMAIL PROTECTED] On Behalf Of Nicola Ken Barozzi Sent: Saturday, October 11, 2003 2:35 PM To: [EMAIL PROTECTED] snip/ I will try to give you something to chew on. Here is an example page (our homepage): site css=default.css

Re: Forrest and the NDS (Re: [RT] Moving towards a new documentation system)

2003-10-12 Thread Jeff Turner
On Sun, Oct 12, 2003 at 12:40:39PM +0200, Stefano Mazzocchi wrote: ... In case something is not clear, I'll be very happy to explain it. My main question is: to users, how is this system functionally different from a Wiki? Eg, a good one that has 'related pages' inferred from the page's

Re: Forrest and the NDS (Re: [RT] Moving towards a new documentation system)

2003-10-12 Thread Alan Gutierrez
* Jeff Turner [EMAIL PROTECTED] [2003-10-12 12:27]: On Sun, Oct 12, 2003 at 12:40:39PM +0200, Stefano Mazzocchi wrote: ... In case something is not clear, I'll be very happy to explain it. My main question is: to users, how is this system functionally different from a Wiki? Eg, a good

RE: Forrest and the NDS (Re: [RT] Moving towards a new documentation system)

2003-10-12 Thread Reinhard Poetz
From: Jeff Turner On Sun, Oct 12, 2003 at 12:40:39PM +0200, Stefano Mazzocchi wrote: ... In case something is not clear, I'll be very happy to explain it. My main question is: to users, how is this system functionally different from a Wiki? Eg, a good one that has 'related pages'

Re: Forrest and the NDS (Re: [RT] Moving towards a new documentation system)

2003-10-12 Thread Alan Gutierrez
* Reinhard Poetz [EMAIL PROTECTED] [2003-10-12 14:06]: Stefano envisions a system where it is very easy to edit content using a WYSIWIG editor (no structured text, no strange XML) for *everybody* by simply clicking on an 'edit' button - without having installed any unknown software - and to

RE: Forrest and the NDS (Re: [RT] Moving towards a new documentation system)

2003-10-12 Thread Reinhard Pötz
From: Alan Gutierrez * Reinhard Poetz [EMAIL PROTECTED] [2003-10-12 14:06]: Stefano envisions a system where it is very easy to edit content using a WYSIWIG editor (no structured text, no strange XML) for *everybody* by simply clicking on an 'edit' button - without having

Re: [RT] Moving towards a new documentation system

2003-10-12 Thread Stefano Mazzocchi
On Sunday, Oct 12, 2003, at 12:05 Europe/Rome, Joerg Heinicke wrote: I think it's just easier to use a number. I don't like the idea of having simply numbers in the URL. Let's have a look on the following URLs: http://www.sueddeutsche.de/deutschland/artikel/420/19401/ Sueddeutsche online has

[RT] Moving towards a new documentation system (was: [RT] Updating the website)

2003-10-11 Thread Bertrand Delacretaz
Le Samedi, 11 oct 2003, à 04:21 Europe/Zurich, David Crossley a écrit : Tony Collen wrote: ...We might need to get away from the developer vs user notion, because depending on how much about Cocoon you already know, you might have to hack out a new generator (which would seem to imply

Re: [RT] Moving towards a new documentation system (was: [RT] Updating the website)

2003-10-11 Thread Stefano Mazzocchi
On Saturday, Oct 11, 2003, at 11:36 Europe/Rome, Bertrand Delacretaz wrote: Le Samedi, 11 oct 2003, à 04:21 Europe/Zurich, David Crossley a écrit : Tony Collen wrote: ...We might need to get away from the developer vs user notion, because depending on how much about Cocoon you already know,

Re: [RT] Moving towards a new documentation system

2003-10-11 Thread Nicola Ken Barozzi
Bertrand Delacretaz wrote: ... I'm starting to think (and I think this resonates with what Tony was saying) that the physical structure of the docs should be flat, wiki-style, having all docs files (real files or generated) in a single directory, of very few directories like reference,

Re: [RT] Moving towards a new documentation system

2003-10-11 Thread Bertrand Delacretaz
Le Samedi, 11 oct 2003, à 14:25 Europe/Zurich, Nicola Ken Barozzi a écrit : Bertrand Delacretaz wrote: ...We can then build all kinds of navigational structures, trails, multiple tables of contents, beginners/advanced, whatever (again picking up on wiki idea of a flat page structure with many

Re: [RT] Moving towards a new documentation system (was: [RT] Updating the website)

2003-10-11 Thread Bertrand Delacretaz
Le Samedi, 11 oct 2003, à 14:11 Europe/Zurich, Stefano Mazzocchi a écrit : ...I think the documents should have a *numerical* identifier that equates them with a URI. http://cocoon.apache.org/cocoon/LO/3948494 I like the unique ID idea, OTOH not having descriptive names makes it hard for

Re: [RT] Moving towards a new documentation system

2003-10-11 Thread Nicola Ken Barozzi
Bertrand Delacretaz wrote: Le Samedi, 11 oct 2003, à 14:25 Europe/Zurich, Nicola Ken Barozzi a écrit : Bertrand Delacretaz wrote: ...We can then build all kinds of navigational structures, trails, multiple tables of contents, beginners/advanced, whatever (again picking up on wiki idea of a

Re: [RT] Moving towards a new documentation system

2003-10-11 Thread Stefano Mazzocchi
On Saturday, Oct 11, 2003, at 14:25 Europe/Rome, Nicola Ken Barozzi wrote: Please don't forget Forrest. we are not. I thought about it and I totally resonate with Bertrand: we need to outline an incremental transition to our own CMS reusing as much dog food as possible (which is also good for

Re: [RT] Moving towards a new documentation system (was: [RT] Updating the website)

2003-10-11 Thread Stefano Mazzocchi
On Saturday, Oct 11, 2003, at 14:58 Europe/Rome, Bertrand Delacretaz wrote: Le Samedi, 11 oct 2003, à 14:11 Europe/Zurich, Stefano Mazzocchi a écrit : ...I think the documents should have a *numerical* identifier that equates them with a URI. http://cocoon.apache.org/cocoon/LO/3948494 I

Re: [RT] Moving towards a new documentation system (was: [RT] Updating the website)

2003-10-11 Thread Nicola Ken Barozzi
Stefano Mazzocchi wrote: ... NOTE: this is *NOT* something that will replace either forrest or lenya. In fact, the idea of this system is to show off *all* the cocoon-related technologies we have in one big showcase for our own use. So, both forrest and lenya should be happy to participate

Re: [RT] Moving towards a new documentation system

2003-10-11 Thread Bertrand Delacretaz
Le Samedi, 11 oct 2003, à 15:33 Europe/Zurich, Stefano Mazzocchi a écrit : On Saturday, Oct 11, 2003, at 14:58 Europe/Rome, Bertrand Delacretaz wrote: ...How about naming files like 3948494-some-descriptive-name-for-humans-here.xml It's like suggesting to have a BugID

Re: [RT] Moving towards a new documentation system

2003-10-11 Thread Nicola Ken Barozzi
Bertrand Delacretaz wrote: ... ...Messy. what would something like this behave? 22003-this-is-first-doc.xml 22003-this-is-second-doc.xml ... that's what I meant by the system having to ensure the uniqueness of IDs. It is certainly problematic. Look at Forrest, we have been having super-easy

RE: [RT] Moving towards a new documentation system

2003-10-11 Thread Robert Koberg
Hi, -Original Message- From: news [mailto:[EMAIL PROTECTED] On Behalf Of Nicola Ken Barozzi Sent: Saturday, October 11, 2003 7:54 AM To: [EMAIL PROTECTED] Bertrand Delacretaz wrote: ... ...Messy. what would something like this behave? 22003-this-is-first-doc.xml

Re: [RT] Moving towards a new documentation system

2003-10-11 Thread Bertrand Delacretaz
Le Samedi, 11 oct 2003, à 16:54 Europe/Zurich, Nicola Ken Barozzi a écrit : Bertrand Delacretaz wrote: ... ...Messy. what would something like this behave? 22003-this-is-first-doc.xml 22003-this-is-second-doc.xml ... that's what I meant by the system having to ensure the uniqueness of IDs.

Re: [RT] Moving towards a new documentation system

2003-10-11 Thread Stefano Mazzocchi
On Saturday, Oct 11, 2003, at 16:54 Europe/Rome, Nicola Ken Barozzi wrote: Bertrand Delacretaz wrote: ... ...Messy. what would something like this behave? 22003-this-is-first-doc.xml 22003-this-is-second-doc.xml ... that's what I meant by the system having to ensure the uniqueness of IDs.

Re: [RT] Moving towards a new documentation system

2003-10-11 Thread Bertrand Delacretaz
Le Samedi, 11 oct 2003, à 17:19 Europe/Zurich, Stefano Mazzocchi a écrit : ...my point is that we should make it hard for people to edit stuff in the repository directly... Ok, I see the idea. There's one additional concern though, which was undelying in my suggestions: it should be as easy

Re: [RT] Moving towards a new documentation system

2003-10-11 Thread Barzilai Spinak
Just for the sake of those of us who know less than you, Cocoon gods. What is the advantage of using an all-numeric filename instead of alphanumeric? If I'm not mistaken by what I sleepily read this morning, you are proposing a flat big bag of documents. So, if there's no hierarchy, an

Re: [RT] Moving towards a new documentation system

2003-10-11 Thread Antonio Gallardo
Stefano Mazzocchi dijo: On Saturday, Oct 11, 2003, at 14:25 Europe/Rome, Nicola Ken Barozzi wrote: Please don't forget Forrest. we are not. I thought about it and I totally resonate with Bertrand: we need to outline an incremental transition to our own CMS reusing as much dog food as

Re: [RT] Moving towards a new documentation system

2003-10-11 Thread Nicola Ken Barozzi
Antonio Gallardo wrote: ... Based on lastest posts, I will like to see a fusion Lenya+Forrest. Is this posible or they are divorced. Synergy. What I want Forrest and Lenya to seek is syergy. I can tell you, as a Forrest committer, that we *love* to do things to make nice DTDs and relative

Re: [RT] Moving towards a new documentation system

2003-10-11 Thread Nicola Ken Barozzi
Robert Koberg wrote: spipped description of forrest site.xml ... Wasn't this all a conversation from a couple of years ago? Yup :-) It is good to see opinions change... Yup, things change. As long as we remain open to change and accept things that people need, things get better. First,

Re: [RT] Moving towards a new documentation system

2003-10-11 Thread Tony Collen
Bertrand Delacretaz wrote: snip/ I'm starting to think (and I think this resonates with what Tony was saying) that the physical structure of the docs should be flat, wiki-style, having all docs files (real files or generated) in a single directory, of very few directories like reference,

RE: [RT] Moving towards a new documentation system

2003-10-11 Thread Robert Koberg
Hi, -Original Message- From: news [mailto:[EMAIL PROTECTED] On Behalf Of Nicola Ken Barozzi Sent: Saturday, October 11, 2003 11:01 AM To: [EMAIL PROTECTED] Robert Koberg wrote: First, forrest's site.xml should change the element names to something generic, like: site

Re: [RT] Moving towards a new documentation system

2003-10-11 Thread Nicola Ken Barozzi
Robert Koberg wrote: ... about forrest's site.xml: The question is: why validate? More than a few reasons: - ensure unique identifiers with the xs:ID datatype good point - ensure valid id references with xs:IDREF for things like: site id=cocoon.apache.org index_page= p1234 page id=p1234/

Forrest and the NDS (Re: [RT] Moving towards a new documentation system)

2003-10-11 Thread Jeff Turner
On Sat, Oct 11, 2003 at 03:17:48PM +0200, Stefano Mazzocchi wrote: On Saturday, Oct 11, 2003, at 14:25 Europe/Rome, Nicola Ken Barozzi wrote: Please don't forget Forrest. we are not. :) Let's remember that there's hard reuse and soft reuse. Hard reuse means physically integrating