Confluence docs experiment

[Mike Kienenberger <mk...@gmail.com>]

There's a "render to static file" process in testing for
auto-converting Confluence documents into web pages as each web page
is updated.

This is an experiment to find a way for Confluence to be supported as
a documentation system, without having end-viewers using confluence
directly.   If Cayene is interested in being a test case, someone
volunteer, and I'll put you in contact with the appropriate people.

They are looking for volunteers with experience in using Confluence
and who have a well-established content-base that they can import.

Re: Confluence docs experiment

[Andrus Adamchik <an...@objectstyle.org>]

On Apr 12, 2006, at 10:02 PM, Cris Daniluk wrote:

> I haven't received confirmation about my apache ID yet. There are  
> three
> different sets of documentation - User, Client, and Modeler. Right  
> now, we
> store them all under CAYDOC. If this is compatible with the current  
> plan,
> then only CAYDOC needs created. Otherwise, we will need to create 3  
> separate
> spaces.

I think all three should go together as one space. In our previous  
discussions we agreed that space == docs version branch. I don't see  
any reason to split it further.

Also we have a CAY space (our main Wiki), but we can probably wait  
with its migration until the things settle down.

Andrus

Re: Confluence docs experiment

[Cris Daniluk <cr...@gmail.com>]

I haven't received confirmation about my apache ID yet. There are three
different sets of documentation - User, Client, and Modeler. Right now, we
store them all under CAYDOC. If this is compatible with the current plan,
then only CAYDOC needs created. Otherwise, we will need to create 3 separate
spaces.

On 4/12/06, Mike Kienenberger <mk...@gmail.com> wrote:
>
> Ok.  Looks like I need the following.
>
> 1) user name -- cdaniluk?  I don't know if this has to have a matching
> apache id yet
> 2) what spaces to be created -- Cayenne User Documentation  (CAYDOC)?
> 3) for what projects (for group access) -- cayenne in incubator
>
>
> On 4/11/06, Cris Daniluk <cr...@gmail.com> wrote:
> > Well you never said this was ASF working on the process :)
> >
> > Sure, I'd like to be involved.
> >
> > On 4/11/06, Mike Kienenberger <mk...@gmail.com> wrote:
> > >
> > > On 4/11/06, Cris Daniluk <cr...@gmail.com> wrote:
> > > > I see what you're talking about. There are several similar plugins
> out
> > > > there... I guess I don't perceive a need to be involved in this
> right
> > > now
> > > > because our server doesn't seem to be too taxed. However, if I'm
> wrong
> > > about
> > > > that... somebody let me know :)
> > >
> > > Let me state it a different way:   If you want to be able to use
> > > Confluence for official Cayenne documentation on ASF resources, this
> > > process is currently the only possibility :)   It'd be in Cayenne's
> > > best interest to make it succeed.
> > >
> >
> >
>

Re: Confluence docs experiment

[Mike Kienenberger <mk...@gmail.com>]

Ok.  Looks like I need the following.

1) user name -- cdaniluk?  I don't know if this has to have a matching
apache id yet
2) what spaces to be created -- Cayenne User Documentation  (CAYDOC)?
3) for what projects (for group access) -- cayenne in incubator


On 4/11/06, Cris Daniluk <cr...@gmail.com> wrote:
> Well you never said this was ASF working on the process :)
>
> Sure, I'd like to be involved.
>
> On 4/11/06, Mike Kienenberger <mk...@gmail.com> wrote:
> >
> > On 4/11/06, Cris Daniluk <cr...@gmail.com> wrote:
> > > I see what you're talking about. There are several similar plugins out
> > > there... I guess I don't perceive a need to be involved in this right
> > now
> > > because our server doesn't seem to be too taxed. However, if I'm wrong
> > about
> > > that... somebody let me know :)
> >
> > Let me state it a different way:   If you want to be able to use
> > Confluence for official Cayenne documentation on ASF resources, this
> > process is currently the only possibility :)   It'd be in Cayenne's
> > best interest to make it succeed.
> >
>
>

Re: Confluence docs experiment

[Mike Kienenberger <mk...@gmail.com>]

On 4/11/06, Cris Daniluk <cr...@gmail.com> wrote:
> Well you never said this was ASF working on the process :)
>
> Sure, I'd like to be involved.

Ok.  Filed as http://issues.apache.org/jira/browse/INFRA-771

Re: Confluence docs experiment

[Mike Kienenberger <mk...@gmail.com>]

On 4/11/06, Cris Daniluk <cr...@gmail.com> wrote:
> Well you never said this was ASF working on the process :)
>
> Sure, I'd like to be involved.

On 4/12/06, Andrus Adamchik <an...@objectstyle.org> wrote:
> I would've volunteered for that as well, as this is a good
> opportunity to both make Confluence happen @Apache and also learn
> more about the infrastructure. But with the JPA push and all the Beta
> tasks that I want to finish ASAP, not sure how realistic this is.

Sorry.   I should have been more clear.


> So Mike you can sign me in as a "backup volunteer". I will certainly
> help with anything that may be needed on the objectstyle.org end.

I'll put Chris down as the contact person (or maybe myself if it
requires a valid apache id) and if Chris needs any help, he can
contact Andrus.

Re: Confluence docs experiment

[Andrus Adamchik <an...@objectstyle.org>]

I would've volunteered for that as well, as this is a good  
opportunity to both make Confluence happen @Apache and also learn  
more about the infrastructure. But with the JPA push and all the Beta  
tasks that I want to finish ASAP, not sure how realistic this is.

So Mike you can sign me in as a "backup volunteer". I will certainly  
help with anything that may be needed on the objectstyle.org end.

Andrus


On Apr 12, 2006, at 3:48 AM, Cris Daniluk wrote:

> Well you never said this was ASF working on the process :)
>
> Sure, I'd like to be involved.
>
> On 4/11/06, Mike Kienenberger <mk...@gmail.com> wrote:
>>
>> On 4/11/06, Cris Daniluk <cr...@gmail.com> wrote:
>>> I see what you're talking about. There are several similar  
>>> plugins out
>>> there... I guess I don't perceive a need to be involved in this  
>>> right
>> now
>>> because our server doesn't seem to be too taxed. However, if I'm  
>>> wrong
>> about
>>> that... somebody let me know :)
>>
>> Let me state it a different way:   If you want to be able to use
>> Confluence for official Cayenne documentation on ASF resources, this
>> process is currently the only possibility :)   It'd be in Cayenne's
>> best interest to make it succeed.
>>

Re: Confluence docs experiment

[Cris Daniluk <cr...@gmail.com>]

Well you never said this was ASF working on the process :)

Sure, I'd like to be involved.

On 4/11/06, Mike Kienenberger <mk...@gmail.com> wrote:
>
> On 4/11/06, Cris Daniluk <cr...@gmail.com> wrote:
> > I see what you're talking about. There are several similar plugins out
> > there... I guess I don't perceive a need to be involved in this right
> now
> > because our server doesn't seem to be too taxed. However, if I'm wrong
> about
> > that... somebody let me know :)
>
> Let me state it a different way:   If you want to be able to use
> Confluence for official Cayenne documentation on ASF resources, this
> process is currently the only possibility :)   It'd be in Cayenne's
> best interest to make it succeed.
>

Re: Confluence docs experiment

[Mike Kienenberger <mk...@gmail.com>]

On 4/11/06, Cris Daniluk <cr...@gmail.com> wrote:
> I see what you're talking about. There are several similar plugins out
> there... I guess I don't perceive a need to be involved in this right now
> because our server doesn't seem to be too taxed. However, if I'm wrong about
> that... somebody let me know :)

Let me state it a different way:   If you want to be able to use
Confluence for official Cayenne documentation on ASF resources, this
process is currently the only possibility :)   It'd be in Cayenne's
best interest to make it succeed.

Re: Confluence docs experiment

[Cris Daniluk <cr...@gmail.com>]

I see what you're talking about. There are several similar plugins out
there... I guess I don't perceive a need to be involved in this right now
because our server doesn't seem to be too taxed. However, if I'm wrong about
that... somebody let me know :)

Cris

On 4/11/06, Mike Kienenberger <mk...@gmail.com> wrote:
>
> As I understand it, the new process is:
>
> 1) a user hits the website and is directed to a static version of the
> Confluence content.
>
> 2) if a user edits a document, he's redirected to the confluence
> version of the site.
>
> 3) After the document is edited, it's automatically converted into a
> static document on the static site.
>
> The goal is to keep the average user off Confluence since it dies
> under heavy load.
>
> On 4/11/06, Cris Daniluk <cr...@gmail.com> wrote:
> > Can you explain more about it? Confluence already has a pretty damn good
> > export function right now, and several projects are using it
> successfully.
> >
> > The only reason we are not is because the TOC generation is just not
> > suitable in Confluence (in fact, its essentially non-existant). I'd be
> > interested in anything that improves on this and saves me the work I'm
> doing
> > right now :)
> >
> >
> > On 4/11/06, Mike Kienenberger <mk...@gmail.com> wrote:
> > >
> > > There's a "render to static file" process in testing for
> > > auto-converting Confluence documents into web pages as each web page
> > > is updated.
> > >
> > > This is an experiment to find a way for Confluence to be supported as
> > > a documentation system, without having end-viewers using confluence
> > > directly.   If Cayene is interested in being a test case, someone
> > > volunteer, and I'll put you in contact with the appropriate people.
> > >
> > > They are looking for volunteers with experience in using Confluence
> > > and who have a well-established content-base that they can import.
> > >
> >
> >
>

Re: Confluence docs experiment

[Mike Kienenberger <mk...@gmail.com>]

As I understand it, the new process is:

1) a user hits the website and is directed to a static version of the
Confluence content.

2) if a user edits a document, he's redirected to the confluence
version of the site.

3) After the document is edited, it's automatically converted into a
static document on the static site.

The goal is to keep the average user off Confluence since it dies
under heavy load.

On 4/11/06, Cris Daniluk <cr...@gmail.com> wrote:
> Can you explain more about it? Confluence already has a pretty damn good
> export function right now, and several projects are using it successfully.
>
> The only reason we are not is because the TOC generation is just not
> suitable in Confluence (in fact, its essentially non-existant). I'd be
> interested in anything that improves on this and saves me the work I'm doing
> right now :)
>
>
> On 4/11/06, Mike Kienenberger <mk...@gmail.com> wrote:
> >
> > There's a "render to static file" process in testing for
> > auto-converting Confluence documents into web pages as each web page
> > is updated.
> >
> > This is an experiment to find a way for Confluence to be supported as
> > a documentation system, without having end-viewers using confluence
> > directly.   If Cayene is interested in being a test case, someone
> > volunteer, and I'll put you in contact with the appropriate people.
> >
> > They are looking for volunteers with experience in using Confluence
> > and who have a well-established content-base that they can import.
> >
>
>

Re: Confluence docs experiment

[Cris Daniluk <cr...@gmail.com>]

Can you explain more about it? Confluence already has a pretty damn good
export function right now, and several projects are using it successfully.

The only reason we are not is because the TOC generation is just not
suitable in Confluence (in fact, its essentially non-existant). I'd be
interested in anything that improves on this and saves me the work I'm doing
right now :)


On 4/11/06, Mike Kienenberger <mk...@gmail.com> wrote:
>
> There's a "render to static file" process in testing for
> auto-converting Confluence documents into web pages as each web page
> is updated.
>
> This is an experiment to find a way for Confluence to be supported as
> a documentation system, without having end-viewers using confluence
> directly.   If Cayene is interested in being a test case, someone
> volunteer, and I'll put you in contact with the appropriate people.
>
> They are looking for volunteers with experience in using Confluence
> and who have a well-established content-base that they can import.
>