You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@geronimo.apache.org by David Blevins <da...@visi.com> on 2005/05/21 03:10:17 UTC

Website possibilities

What do people think of having a website like this one?

  http://docs.openejb.org/Home

Obviously, with a different look, but something with the same dynamic content.

The main content comes from Confluence.
The "Activity" section is dynamically created from Jira items.
The "News" section is from Confluence blog posts.
The "Recently Updated" section is a confluence macro.
The whole thing is put together with a modified version of Confluenza.
With mod_rewrite rules, it's still possible to have static conent.

Seems to me like a good way to always have our activity show up on the website, but wihtout having to do anything more than we are already doing.

Any thoughts?

-David

Re: Website possibilities

Posted by David Blevins <da...@visi.com>.
Well, I think a part of the problem is that Confluenza expects too much from Confluence.  I think there is something that can be done about it, but As I say, we aren't there yet.  Certainly not going to switch over the OpenEJB site just yet.

-David

On Fri, May 27, 2005 at 07:13:18AM -0400, Geir Magnusson Jr. wrote:
> The only issue I see is that at least over at codehaus, they can't  
> seem to get Confluence to stabilize.  How stable and scalable is it?
> 
> geir
> 
> On May 26, 2005, at 3:54 AM, David Blevins wrote:
> 
> >I somehow missed your reply--anyone know how to get mutt to stop  
> >marking things as "Old"?
> >
> >Anyway, answers below....
> >
> >On Sun, May 22, 2005 at 12:04:55PM +1000, Gianny Damour wrote:
> >
> >>I love it!
> >>
> >>And I especially love the "Activity" section; this is one of the  
> >>thing
> >>that will help to provide a high-level overview of the activities.
> >>
> >
> >I like that it shows a heartbeat.  It's also kind of cool that it  
> >shows who opened the item and who closed it.  Seems like getting  
> >your name on the front page for a bit is good motivation to get  
> >involved.  Ditto for the "Recently Updated" section.
> >
> >
> >>
> >>I do have a couple of questions about the features of Confluence or
> >>Confluenza:
> >>
> >
> >We don't really need Confluenza.  Sans the caching, it just grabs  
> >html from Confluence and munges it to fix links and junk like that.
> >
> >
> >>* Can we export the overall website to an html tarball or even  
> >>better a PDF?
> >>
> >
> >Confluence does PDF.  So we could squirt one of those into every  
> >release, for example.  Not sure about HTML, but I'm guessing, yes.
> >
> >
> >>* Can we add support for search capabilities?
> >>
> >
> >Sure, Confluence has that already.  We'd just need a text box in  
> >the template.
> >
> >
> >>* When the documentation will start to grow, do you think that we  
> >>will
> >>be able to "easily" refactor the content? For instance, with  
> >>Microsoft
> >>Word (sorry for this poor example), there is an outline mode to
> >>(re-)structure a doc.
> >>
> >
> >You can move and rename stuff very easily.  Not sure how involved  
> >it would be to change the same fiddly-bit on every page, for  
> >example.  I guess if you had something major to do, you could  
> >export, change, and import.
> >
> >
> >>* Can we have an automatic hierarchical overview of the website  
> >>content?
> >>I mean, is the left navigation bar automatically generated from the
> >>content of the website or do we need to maintain it? Here, I am  
> >>looking
> >>for something a la document map of Microsoft Word (sorry...)
> >>
> >
> >We would maintain that.  Confluence does show a hierarchical view  
> >of the content in the wiki, but I'd think we'd want something  
> >sorted to our preference as a navigation bar.
> >
> >
> >>I had a look to the Confluence Web site and it seems that Confluence
> >>addresses all of these questions. However, I do not know the level of
> >>simplification that the platform delivers.
> >>
> >
> >I assume that was the long way of saying, "is it easy?" :-)  Yea,  
> >I've found it pretty easy so far.  I've worked with our existing  
> >wiki and never found it intuative.
> >
> >
> >>If the new tool box allows for an easier maintenance of the website,
> >>then we should use it. Based on the fact that you are recommending a
> >>migration, then it sounds reasonable to make this move.
> >>
> >
> >We aren't there yet, but I don't see any obstacles.  Been chatting  
> >with some of the infrastructure guys (who are very nice) and they  
> >think it's pretty cool.
> >
> >It's amazing how far you get with a simple "hello."
> >
> >
> >>Thanks David for making an old discussion a reality.
> >>
> >
> >Well, people want a website that isn't dead, they want an M4, and  
> >they want us certified.  Just trying to put some effort into the  
> >areas we've ignored.
> >
> >-David
> >
> >
> >>Gianny
> >>
> >>On 21/05/2005 11:10 AM, David Blevins wrote:
> >>
> >>
> >>>What do people think of having a website like this one?
> >>>
> >>>http://docs.openejb.org/Home
> >>>
> >>>Obviously, with a different look, but something with the same  
> >>>dynamic
> >>>content.
> >>>
> >>>The main content comes from Confluence.
> >>>The "Activity" section is dynamically created from Jira items.
> >>>The "News" section is from Confluence blog posts.
> >>>The "Recently Updated" section is a confluence macro.
> >>>The whole thing is put together with a modified version of  
> >>>Confluenza.
> >>>With mod_rewrite rules, it's still possible to have static conent.
> >>>
> >>>Seems to me like a good way to always have our activity show up  
> >>>on the
> >>>website, but wihtout having to do anything more than we are  
> >>>already doing.
> >>>
> >>>Any thoughts?
> >>>
> >>>-David
> >>>
> >>>
> >>>
> >>>
> >
> >
> 
> -- 
> Geir Magnusson Jr                                  +1-203-665-6437
> geirm@apache.org
> 

Re: Website possibilities

Posted by "Geir Magnusson Jr." <ge...@apache.org>.
The only issue I see is that at least over at codehaus, they can't  
seem to get Confluence to stabilize.  How stable and scalable is it?

geir

On May 26, 2005, at 3:54 AM, David Blevins wrote:

> I somehow missed your reply--anyone know how to get mutt to stop  
> marking things as "Old"?
>
> Anyway, answers below....
>
> On Sun, May 22, 2005 at 12:04:55PM +1000, Gianny Damour wrote:
>
>> I love it!
>>
>> And I especially love the "Activity" section; this is one of the  
>> thing
>> that will help to provide a high-level overview of the activities.
>>
>
> I like that it shows a heartbeat.  It's also kind of cool that it  
> shows who opened the item and who closed it.  Seems like getting  
> your name on the front page for a bit is good motivation to get  
> involved.  Ditto for the "Recently Updated" section.
>
>
>>
>> I do have a couple of questions about the features of Confluence or
>> Confluenza:
>>
>
> We don't really need Confluenza.  Sans the caching, it just grabs  
> html from Confluence and munges it to fix links and junk like that.
>
>
>> * Can we export the overall website to an html tarball or even  
>> better a PDF?
>>
>
> Confluence does PDF.  So we could squirt one of those into every  
> release, for example.  Not sure about HTML, but I'm guessing, yes.
>
>
>> * Can we add support for search capabilities?
>>
>
> Sure, Confluence has that already.  We'd just need a text box in  
> the template.
>
>
>> * When the documentation will start to grow, do you think that we  
>> will
>> be able to "easily" refactor the content? For instance, with  
>> Microsoft
>> Word (sorry for this poor example), there is an outline mode to
>> (re-)structure a doc.
>>
>
> You can move and rename stuff very easily.  Not sure how involved  
> it would be to change the same fiddly-bit on every page, for  
> example.  I guess if you had something major to do, you could  
> export, change, and import.
>
>
>> * Can we have an automatic hierarchical overview of the website  
>> content?
>> I mean, is the left navigation bar automatically generated from the
>> content of the website or do we need to maintain it? Here, I am  
>> looking
>> for something a la document map of Microsoft Word (sorry...)
>>
>
> We would maintain that.  Confluence does show a hierarchical view  
> of the content in the wiki, but I'd think we'd want something  
> sorted to our preference as a navigation bar.
>
>
>> I had a look to the Confluence Web site and it seems that Confluence
>> addresses all of these questions. However, I do not know the level of
>> simplification that the platform delivers.
>>
>
> I assume that was the long way of saying, "is it easy?" :-)  Yea,  
> I've found it pretty easy so far.  I've worked with our existing  
> wiki and never found it intuative.
>
>
>> If the new tool box allows for an easier maintenance of the website,
>> then we should use it. Based on the fact that you are recommending a
>> migration, then it sounds reasonable to make this move.
>>
>
> We aren't there yet, but I don't see any obstacles.  Been chatting  
> with some of the infrastructure guys (who are very nice) and they  
> think it's pretty cool.
>
> It's amazing how far you get with a simple "hello."
>
>
>> Thanks David for making an old discussion a reality.
>>
>
> Well, people want a website that isn't dead, they want an M4, and  
> they want us certified.  Just trying to put some effort into the  
> areas we've ignored.
>
> -David
>
>
>> Gianny
>>
>> On 21/05/2005 11:10 AM, David Blevins wrote:
>>
>>
>>> What do people think of having a website like this one?
>>>
>>> http://docs.openejb.org/Home
>>>
>>> Obviously, with a different look, but something with the same  
>>> dynamic
>>> content.
>>>
>>> The main content comes from Confluence.
>>> The "Activity" section is dynamically created from Jira items.
>>> The "News" section is from Confluence blog posts.
>>> The "Recently Updated" section is a confluence macro.
>>> The whole thing is put together with a modified version of  
>>> Confluenza.
>>> With mod_rewrite rules, it's still possible to have static conent.
>>>
>>> Seems to me like a good way to always have our activity show up  
>>> on the
>>> website, but wihtout having to do anything more than we are  
>>> already doing.
>>>
>>> Any thoughts?
>>>
>>> -David
>>>
>>>
>>>
>>>
>
>

-- 
Geir Magnusson Jr                                  +1-203-665-6437
geirm@apache.org



Re: Website possibilities

Posted by David Blevins <da...@visi.com>.
I somehow missed your reply--anyone know how to get mutt to stop marking things as "Old"?

Anyway, answers below....

On Sun, May 22, 2005 at 12:04:55PM +1000, Gianny Damour wrote:
> I love it!
> 
> And I especially love the "Activity" section; this is one of the thing 
> that will help to provide a high-level overview of the activities.

I like that it shows a heartbeat.  It's also kind of cool that it shows who opened the item and who closed it.  Seems like getting your name on the front page for a bit is good motivation to get involved.  Ditto for the "Recently Updated" section.  

> 
> I do have a couple of questions about the features of Confluence or 
> Confluenza:

We don't really need Confluenza.  Sans the caching, it just grabs html from Confluence and munges it to fix links and junk like that.

> * Can we export the overall website to an html tarball or even better a PDF?

Confluence does PDF.  So we could squirt one of those into every release, for example.  Not sure about HTML, but I'm guessing, yes.

> * Can we add support for search capabilities?

Sure, Confluence has that already.  We'd just need a text box in the template.

> * When the documentation will start to grow, do you think that we will 
> be able to "easily" refactor the content? For instance, with Microsoft 
> Word (sorry for this poor example), there is an outline mode to 
> (re-)structure a doc.

You can move and rename stuff very easily.  Not sure how involved it would be to change the same fiddly-bit on every page, for example.  I guess if you had something major to do, you could export, change, and import.

> * Can we have an automatic hierarchical overview of the website content? 
> I mean, is the left navigation bar automatically generated from the 
> content of the website or do we need to maintain it? Here, I am looking 
> for something a la document map of Microsoft Word (sorry...)

We would maintain that.  Confluence does show a hierarchical view of the content in the wiki, but I'd think we'd want something sorted to our preference as a navigation bar.

> I had a look to the Confluence Web site and it seems that Confluence 
> addresses all of these questions. However, I do not know the level of  
> simplification that the platform delivers.

I assume that was the long way of saying, "is it easy?" :-)  Yea, I've found it pretty easy so far.  I've worked with our existing wiki and never found it intuative.

> If the new tool box allows for an easier maintenance of the website, 
> then we should use it. Based on the fact that you are recommending a 
> migration, then it sounds reasonable to make this move.

We aren't there yet, but I don't see any obstacles.  Been chatting with some of the infrastructure guys (who are very nice) and they think it's pretty cool.

It's amazing how far you get with a simple "hello."

> Thanks David for making an old discussion a reality.

Well, people want a website that isn't dead, they want an M4, and they want us certified.  Just trying to put some effort into the areas we've ignored.

-David

> Gianny
> 
> On 21/05/2005 11:10 AM, David Blevins wrote:
> 
> >What do people think of having a website like this one?
> >
> > http://docs.openejb.org/Home
> >
> >Obviously, with a different look, but something with the same dynamic 
> >content.
> >
> >The main content comes from Confluence.
> >The "Activity" section is dynamically created from Jira items.
> >The "News" section is from Confluence blog posts.
> >The "Recently Updated" section is a confluence macro.
> >The whole thing is put together with a modified version of Confluenza.
> >With mod_rewrite rules, it's still possible to have static conent.
> >
> >Seems to me like a good way to always have our activity show up on the 
> >website, but wihtout having to do anything more than we are already doing.
> >
> >Any thoughts?
> >
> >-David
> >
> > 
> >

Re: Website possibilities

Posted by Gianny Damour <gi...@optusnet.com.au>.
I love it!

And I especially love the "Activity" section; this is one of the thing 
that will help to provide a high-level overview of the activities.

I do have a couple of questions about the features of Confluence or 
Confluenza:
* Can we export the overall website to an html tarball or even better a PDF?
* Can we add support for search capabilities?
* When the documentation will start to grow, do you think that we will 
be able to "easily" refactor the content? For instance, with Microsoft 
Word (sorry for this poor example), there is an outline mode to 
(re-)structure a doc.
* Can we have an automatic hierarchical overview of the website content? 
I mean, is the left navigation bar automatically generated from the 
content of the website or do we need to maintain it? Here, I am looking 
for something a la document map of Microsoft Word (sorry...)

I had a look to the Confluence Web site and it seems that Confluence 
addresses all of these questions. However, I do not know the level of  
simplification that the platform delivers.

If the new tool box allows for an easier maintenance of the website, 
then we should use it. Based on the fact that you are recommending a 
migration, then it sounds reasonable to make this move.

Thanks David for making an old discussion a reality.

Gianny

On 21/05/2005 11:10 AM, David Blevins wrote:

>What do people think of having a website like this one?
>
>  http://docs.openejb.org/Home
>
>Obviously, with a different look, but something with the same dynamic content.
>
>The main content comes from Confluence.
>The "Activity" section is dynamically created from Jira items.
>The "News" section is from Confluence blog posts.
>The "Recently Updated" section is a confluence macro.
>The whole thing is put together with a modified version of Confluenza.
>With mod_rewrite rules, it's still possible to have static conent.
>
>Seems to me like a good way to always have our activity show up on the website, but wihtout having to do anything more than we are already doing.
>
>Any thoughts?
>
>-David
>
>  
>


Re: Website possibilities

Posted by David Blevins <da...@visi.com>.
On Sat, May 21, 2005 at 11:25:54PM +0200, Jacek Laskowski wrote:
> David Blevins wrote:
> >What do people think of having a website like this one?
> >
> >  http://docs.openejb.org/Home
> >
> >Obviously, with a different look, but something with the same dynamic 
> >content.
> >
> >The main content comes from Confluence.
> >The "Activity" section is dynamically created from Jira items.
> >The "News" section is from Confluence blog posts.
> >The "Recently Updated" section is a confluence macro.
> >The whole thing is put together with a modified version of Confluenza.
> >With mod_rewrite rules, it's still possible to have static conent.
> >
> >Seems to me like a good way to always have our activity show up on the 
> >website, but wihtout having to do anything more than we are already doing.
> >
> >Any thoughts?
> 
> It seems to be much better than what we've got so far. If you know the 
> tool and encourage others to use it, I believe it must be the right 
> tool. It's enough to me to vote for it.
> 
> Would that mean that Wiki would become obsolete? Unless I'm mistaken, 
> Confluence is just a commercial flavour of Wiki, isn't it?

Sorry for the late reply.  I somehow missed yours and Gianny's.

Confluence is a wiki, as you point out.  We could have two wiki's, though I doubt that would make us very popular :)

-David

Re: Website possibilities

Posted by Jacek Laskowski <jl...@apache.org>.
David Blevins wrote:
> What do people think of having a website like this one?
> 
>   http://docs.openejb.org/Home
> 
> Obviously, with a different look, but something with the same dynamic content.
> 
> The main content comes from Confluence.
> The "Activity" section is dynamically created from Jira items.
> The "News" section is from Confluence blog posts.
> The "Recently Updated" section is a confluence macro.
> The whole thing is put together with a modified version of Confluenza.
> With mod_rewrite rules, it's still possible to have static conent.
> 
> Seems to me like a good way to always have our activity show up on the website, but wihtout having to do anything more than we are already doing.
> 
> Any thoughts?

It seems to be much better than what we've got so far. If you know the 
tool and encourage others to use it, I believe it must be the right 
tool. It's enough to me to vote for it.

Would that mean that Wiki would become obsolete? Unless I'm mistaken, 
Confluence is just a commercial flavour of Wiki, isn't it?

> -David

Jacek


Re: Website possibilities

Posted by David Blevins <da...@visi.com>.
On Fri, May 20, 2005 at 08:20:59PM -0600, Bruce Snyder wrote:
> On 5/20/05, David Blevins <da...@visi.com> wrote:
> > Oh and just so it's clear, I am volunteering to setup and maintain this as I know infrastructure is already swamped.
> > 
> > Any other volunteers would be greatly appreciated.
> 
> I'm definitely willing to help with this, no matter what solution is
> used. However, I see a problem with Confluence in that the ASF does
> not have Confluence, does it?

I'd be happy to get a license, set it up, and keep it running.

-David

Re: Website possibilities

Posted by Bruce Snyder <br...@gmail.com>.
On 5/20/05, David Blevins <da...@visi.com> wrote:
> Oh and just so it's clear, I am volunteering to setup and maintain this as I know infrastructure is already swamped.
> 
> Any other volunteers would be greatly appreciated.

I'm definitely willing to help with this, no matter what solution is
used. However, I see a problem with Confluence in that the ASF does
not have Confluence, does it?

Bruce 
-- 
perl -e 'print unpack("u30","D0G)U8V4\@4VYY9&5R\"F)R=6-E+G-N>61E<D\!G;6%I;\"YC;VT*"
);'

The Castor Project
http://www.castor.org/

Apache Geronimo
http://geronimo.apache.org/

Re: Website possibilities

Posted by David Blevins <da...@visi.com>.
Oh and just so it's clear, I am volunteering to setup and maintain this as I know infrastructure is already swamped.

Any other volunteers would be greatly appreciated.

-David

On Fri, May 20, 2005 at 06:10:17PM -0700, David Blevins wrote:
> What do people think of having a website like this one?
> 
>   http://docs.openejb.org/Home
> 
> Obviously, with a different look, but something with the same dynamic content.
> 
> The main content comes from Confluence.
> The "Activity" section is dynamically created from Jira items.
> The "News" section is from Confluence blog posts.
> The "Recently Updated" section is a confluence macro.
> The whole thing is put together with a modified version of Confluenza.
> With mod_rewrite rules, it's still possible to have static conent.
> 
> Seems to me like a good way to always have our activity show up on the website, but wihtout having to do anything more than we are already doing.
> 
> Any thoughts?
> 
> -David