You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@geronimo.apache.org by Aaron Mulder <am...@alumni.princeton.edu> on 2004/07/20 23:46:07 UTC
Manual
I think I'm climbing out from under my rock, at least a little
bit, and I'd like to start work on a manual. If I can produce a HTML
version, what's the best way to get it included on the geronimo.apache.org
web site? I'm thinking we should add a Documentation link to the left
navigation bar (probably under the "Geronimo" header) and then on that
page include a link to the HTML manual as well as to the Maven FAQ and
perhaps a couple Wiki links to flesh it out.
Thanks,
Aaron
Re: Manual
Posted by Aaron Mulder <am...@alumni.princeton.edu>.
I guess I agree to a limited extent. I think the wiki is great
for *developing* documentation -- FAQ's and guidance for specific topics
and so on -- but I'd like to put together a more polished document as the
main manual -- perhaps the standard routine where we make it available
electronically on the site and get it published in hardcopy as well. To
that end, I guess I'm envisioning a little more structure and control than
the Wiki provides. But there's certainly room for both -- it promises to
be a long effort, and a mix of FAQ's and HOWTOs and a structured manual
and a plentiful supply of regular books would be great.
Aaron
P.S. Haven't we switched Wiki's once already? :)
On Tue, 20 Jul 2004, Dain Sundstrom wrote:
> I personally think the wiki is the best place to develop documentation,
> because everyone can participate. The issue is our wiki software is...
> lets say difficult. James Strachan has a neat utility for Confluence
> wiki, which Codehaus uses, that converts the wiki markup to html, pdf
> and runs all the test cases coded into the wiki. I would like to
> follow a similar route for our docs where we develop them on the wiki
> and regularly stamp them and check them into the project xdocs.
>
> Does anyone know what we need to do to get Confluence running at Apache?
>
> -dain
>
> On Jul 20, 2004, at 2:46 PM, Aaron Mulder wrote:
>
> > I think I'm climbing out from under my rock, at least a little
> > bit, and I'd like to start work on a manual. If I can produce a HTML
> > version, what's the best way to get it included on the
> > geronimo.apache.org
> > web site? I'm thinking we should add a Documentation link to the left
> > navigation bar (probably under the "Geronimo" header) and then on that
> > page include a link to the HTML manual as well as to the Maven FAQ and
> > perhaps a couple Wiki links to flesh it out.
> >
> > Thanks,
> > Aaron
>
>
Re: Installing Confluence [was Re: Manual]
Posted by Matt Kurjanowicz <ma...@gmail.com>.
I'll volunteer my time (of course) to anything I can, I'm not a
committer, so I can't do anything server side, but anything that I can
do without committer privileges I'd love to help to do.
Thanks,
Matt Kurjanowicz
On Fri, 23 Jul 2004 13:21:09 +1000, Jeff Turner <je...@apache.org> wrote:
> On Thu, Jul 22, 2004 at 09:23:35PM -0500, David Blevins wrote:
> > I could help but know little to nothing about Confluence. Are there
> > any Confluence devs out there who would be willing to answer questions
> > on irc or something from time to time?
>
> Yes, Mike [1] just volunteered IRC/IM support from any Confluence devs
> who happen to be awake. Otherwise mail confluence-support@atlassian.com,
> or if it's ASF-specific, give me a poke.
>
> --Jeff
>
> [1] Mike Cannon-brookes is substantially to blame for Confluence - his IM
> details are at http://confluence.atlassian.com/display/~mike@atlassian.com
>
>
>
> > -David
> >
> > On Fri, Jul 23, 2004 at 11:51:12AM +1000, Jeff Turner wrote:
> > > Would anyone else be willing to help with care and feeding of an ASF
> > > Confluence instance? Requirements for the job:
> > >
> > > a) an ASF committer, preferably been around a few years
> > > b) know how to deploy a webapp and admin a Tomcat instance
> > > c) somewhat unix-savvy
> > > d) willing to commit random bits of time for months to come to do things
> > > like upgrades
> > >
> > > If there's a volunteer or two, I guess the next steps would be to hold a
> > > (PMC-ratified) vote and send a mail off to infrastructure@ for advice.
> > > They may wish to delay installation until a successor to nagoya is ready.
> > >
> > >
> > > --Jeff
> > >
> > > On Thu, Jul 22, 2004 at 05:11:40PM +0100, jastrachan@mac.com wrote:
> > > >
> > > > On 21 Jul 2004, at 17:15, Matt Kurjanowicz wrote:
> > > > >Hmm, are we moving a little too fast on moving to Confluence? Like
> > > > >someone said earlier, we've already switched wiki's once, and I don't
> > > > >know (beyond wiki -> xdoc) what benefits Confluence has over Wikis.
> > > >
> > > > Security, features, wiki language, macros for integrating with unit
> > > > test code / JIRA reports - but mostly its just a nice tool to use etc.
> > > >
> > > > Its like saying, hey this JIRA things OK but whats wrong with bugzilla.
> > > > If you've used both you'll know what I mean.
> > > >
> > > >
> > > > >It may even be easier to update the tool (wiki->xdoc) to understand
> > > > >the wiki we have now, rather than transferring the entire site over to
> > > > >a different wiki system, with yet another syntax...
> > > >
> > > > There's not that much content. But we could start with just the manual
> > > > in the new wiki, then see how we get on. The great thing about this
> > > > internet thing is we can link across websites :). So even if the old
> > > > wiki stays around for a while its no biggie
> > > >
> > > > James
> > > > -------
> > > > http://radio.weblogs.com/0112098/
> > > >
>
--
Matthew Kurjanowicz
matt.kurjanowicz@gmail.com
The Readme Plugin
http://projassist.sourceforge.net/readme-plugin/
The Projassist Project
* Making Bug-Tracking Easy *
http://projassist.sourceforge.net/
Re: Installing Confluence [was Re: Manual]
Posted by Jeff Turner <je...@apache.org>.
On Thu, Jul 22, 2004 at 09:23:35PM -0500, David Blevins wrote:
> I could help but know little to nothing about Confluence. Are there
> any Confluence devs out there who would be willing to answer questions
> on irc or something from time to time?
Yes, Mike [1] just volunteered IRC/IM support from any Confluence devs
who happen to be awake. Otherwise mail confluence-support@atlassian.com,
or if it's ASF-specific, give me a poke.
--Jeff
[1] Mike Cannon-brookes is substantially to blame for Confluence - his IM
details are at http://confluence.atlassian.com/display/~mike@atlassian.com
> -David
>
> On Fri, Jul 23, 2004 at 11:51:12AM +1000, Jeff Turner wrote:
> > Would anyone else be willing to help with care and feeding of an ASF
> > Confluence instance? Requirements for the job:
> >
> > a) an ASF committer, preferably been around a few years
> > b) know how to deploy a webapp and admin a Tomcat instance
> > c) somewhat unix-savvy
> > d) willing to commit random bits of time for months to come to do things
> > like upgrades
> >
> > If there's a volunteer or two, I guess the next steps would be to hold a
> > (PMC-ratified) vote and send a mail off to infrastructure@ for advice.
> > They may wish to delay installation until a successor to nagoya is ready.
> >
> >
> > --Jeff
> >
> > On Thu, Jul 22, 2004 at 05:11:40PM +0100, jastrachan@mac.com wrote:
> > >
> > > On 21 Jul 2004, at 17:15, Matt Kurjanowicz wrote:
> > > >Hmm, are we moving a little too fast on moving to Confluence? Like
> > > >someone said earlier, we've already switched wiki's once, and I don't
> > > >know (beyond wiki -> xdoc) what benefits Confluence has over Wikis.
> > >
> > > Security, features, wiki language, macros for integrating with unit
> > > test code / JIRA reports - but mostly its just a nice tool to use etc.
> > >
> > > Its like saying, hey this JIRA things OK but whats wrong with bugzilla.
> > > If you've used both you'll know what I mean.
> > >
> > >
> > > >It may even be easier to update the tool (wiki->xdoc) to understand
> > > >the wiki we have now, rather than transferring the entire site over to
> > > >a different wiki system, with yet another syntax...
> > >
> > > There's not that much content. But we could start with just the manual
> > > in the new wiki, then see how we get on. The great thing about this
> > > internet thing is we can link across websites :). So even if the old
> > > wiki stays around for a while its no biggie
> > >
> > > James
> > > -------
> > > http://radio.weblogs.com/0112098/
> > >
Re: Installing Confluence [was Re: Manual]
Posted by David Blevins <da...@visi.com>.
I could help but know little to nothing about Confluence. Are there
any Confluence devs out there who would be willing to answer questions
on irc or something from time to time?
-David
On Fri, Jul 23, 2004 at 11:51:12AM +1000, Jeff Turner wrote:
> Would anyone else be willing to help with care and feeding of an ASF
> Confluence instance? Requirements for the job:
>
> a) an ASF committer, preferably been around a few years
> b) know how to deploy a webapp and admin a Tomcat instance
> c) somewhat unix-savvy
> d) willing to commit random bits of time for months to come to do things
> like upgrades
>
> If there's a volunteer or two, I guess the next steps would be to hold a
> (PMC-ratified) vote and send a mail off to infrastructure@ for advice.
> They may wish to delay installation until a successor to nagoya is ready.
>
>
> --Jeff
>
> On Thu, Jul 22, 2004 at 05:11:40PM +0100, jastrachan@mac.com wrote:
> >
> > On 21 Jul 2004, at 17:15, Matt Kurjanowicz wrote:
> > >Hmm, are we moving a little too fast on moving to Confluence? Like
> > >someone said earlier, we've already switched wiki's once, and I don't
> > >know (beyond wiki -> xdoc) what benefits Confluence has over Wikis.
> >
> > Security, features, wiki language, macros for integrating with unit
> > test code / JIRA reports - but mostly its just a nice tool to use etc.
> >
> > Its like saying, hey this JIRA things OK but whats wrong with bugzilla.
> > If you've used both you'll know what I mean.
> >
> >
> > >It may even be easier to update the tool (wiki->xdoc) to understand
> > >the wiki we have now, rather than transferring the entire site over to
> > >a different wiki system, with yet another syntax...
> >
> > There's not that much content. But we could start with just the manual
> > in the new wiki, then see how we get on. The great thing about this
> > internet thing is we can link across websites :). So even if the old
> > wiki stays around for a while its no biggie
> >
> > James
> > -------
> > http://radio.weblogs.com/0112098/
> >
Re: Installing Confluence
Posted by Bruce Snyder <fe...@frii.com>.
This one time, at band camp, Dain Sundstrom said:
DS>So last night as part of the release schedule I needed to update our
DS>wiki, and it took me a half hour just to figure out how to login
DS>MoinMoin...
I like MoinMoin much better than UseMod, but some of its usability
still isn't that great. Confluence is much more polished.
DS>Can anyone give us an up or down answer on if we can get confluence
DS>installed at Apache? If it we can't, I propose we find confluence
DS>space for Geronimo somewhere offsite.
I would say just go to Codehaus. But, IIRC, didn't we get our hands
slapped for using an external website previously (maybe that was
in Incubator thing)? At the same time, the Maven project already
does this, and with Codehaus to boot.
Bruce
--
perl -e 'print unpack("u30","<0G)U8V4\@4VYY9&5R\"F9E<G)E=\$\!F<FEI+F-O;0\`\`");'
The Castor Project
http://www.castor.org/
Apache Geronimo
http://incubator.apache.org/projects/geronimo.html
Re: Installing Confluence
Posted by Dain Sundstrom <ds...@gluecode.com>.
So last night as part of the release schedule I needed to update our
wiki, and it took me a half hour just to figure out how to login
MoinMoin...
Can anyone give us an up or down answer on if we can get confluence
installed at Apache? If it we can't, I propose we find confluence
space for Geronimo somewhere offsite.
-dain
On Sep 8, 2004, at 1:59 PM, David Blevins wrote:
> I also volunteered to help when the original thread was going on.
> Would be nice to see this setup.
>
> -David
>
> On Tue, Sep 07, 2004 at 10:08:20AM -0700, Dain Sundstrom wrote:
>> Does anyone know where we are at with this? I am more than willing to
>> help.
>>
>> -dain
>>
>>
>> On Jul 22, 2004, at 9:11 PM, jastrachan@mac.com wrote:
>>
>>> I'm willing to help out - I just about qualify for the requirements I
>>> guess.
>>>
>>> On 23 Jul 2004, at 02:51, Jeff Turner wrote:
>>>> Would anyone else be willing to help with care and feeding of an ASF
>>>> Confluence instance? Requirements for the job:
>>>>
>>>> a) an ASF committer, preferably been around a few years
>>>> b) know how to deploy a webapp and admin a Tomcat instance
>>>> c) somewhat unix-savvy
>>>> d) willing to commit random bits of time for months to come to do
>>>> things
>>>> like upgrades
>>>>
>>>> If there's a volunteer or two, I guess the next steps would be to
>>>> hold a
>>>> (PMC-ratified) vote and send a mail off to infrastructure@ for
>>>> advice.
>>>> They may wish to delay installation until a successor to nagoya is
>>>> ready.
>>>>
>>>>
>>>> --Jeff
>>>>
>>>> On Thu, Jul 22, 2004 at 05:11:40PM +0100, jastrachan@mac.com wrote:
>>>>>
>>>>> On 21 Jul 2004, at 17:15, Matt Kurjanowicz wrote:
>>>>>> Hmm, are we moving a little too fast on moving to Confluence?
>>>>>> Like
>>>>>> someone said earlier, we've already switched wiki's once, and I
>>>>>> don't
>>>>>> know (beyond wiki -> xdoc) what benefits Confluence has over
>>>>>> Wikis.
>>>>>
>>>>> Security, features, wiki language, macros for integrating with unit
>>>>> test code / JIRA reports - but mostly its just a nice tool to use
>>>>> etc.
>>>>>
>>>>> Its like saying, hey this JIRA things OK but whats wrong with
>>>>> bugzilla.
>>>>> If you've used both you'll know what I mean.
>>>>>
>>>>>
>>>>>> It may even be easier to update the tool (wiki->xdoc) to
>>>>>> understand
>>>>>> the wiki we have now, rather than transferring the entire site
>>>>>> over
>>>>>> to
>>>>>> a different wiki system, with yet another syntax...
>>>>>
>>>>> There's not that much content. But we could start with just the
>>>>> manual
>>>>> in the new wiki, then see how we get on. The great thing about this
>>>>> internet thing is we can link across websites :). So even if the
>>>>> old
>>>>> wiki stays around for a while its no biggie
>>>>>
>>>>> James
>>>>> -------
>>>>> http://radio.weblogs.com/0112098/
>>>>>
>>>>
>>>>
>>>
>>> James
>>> -------
>>> http://radio.weblogs.com/0112098/
>>>
Re: Installing Confluence
Posted by David Blevins <da...@visi.com>.
I also volunteered to help when the original thread was going on. Would be nice to see this setup.
-David
On Tue, Sep 07, 2004 at 10:08:20AM -0700, Dain Sundstrom wrote:
> Does anyone know where we are at with this? I am more than willing to
> help.
>
> -dain
>
>
> On Jul 22, 2004, at 9:11 PM, jastrachan@mac.com wrote:
>
> >I'm willing to help out - I just about qualify for the requirements I
> >guess.
> >
> >On 23 Jul 2004, at 02:51, Jeff Turner wrote:
> >>Would anyone else be willing to help with care and feeding of an ASF
> >>Confluence instance? Requirements for the job:
> >>
> >> a) an ASF committer, preferably been around a few years
> >> b) know how to deploy a webapp and admin a Tomcat instance
> >> c) somewhat unix-savvy
> >> d) willing to commit random bits of time for months to come to do
> >>things
> >> like upgrades
> >>
> >>If there's a volunteer or two, I guess the next steps would be to
> >>hold a
> >>(PMC-ratified) vote and send a mail off to infrastructure@ for advice.
> >>They may wish to delay installation until a successor to nagoya is
> >>ready.
> >>
> >>
> >>--Jeff
> >>
> >>On Thu, Jul 22, 2004 at 05:11:40PM +0100, jastrachan@mac.com wrote:
> >>>
> >>>On 21 Jul 2004, at 17:15, Matt Kurjanowicz wrote:
> >>>>Hmm, are we moving a little too fast on moving to Confluence? Like
> >>>>someone said earlier, we've already switched wiki's once, and I
> >>>>don't
> >>>>know (beyond wiki -> xdoc) what benefits Confluence has over Wikis.
> >>>
> >>>Security, features, wiki language, macros for integrating with unit
> >>>test code / JIRA reports - but mostly its just a nice tool to use
> >>>etc.
> >>>
> >>>Its like saying, hey this JIRA things OK but whats wrong with
> >>>bugzilla.
> >>>If you've used both you'll know what I mean.
> >>>
> >>>
> >>>>It may even be easier to update the tool (wiki->xdoc) to understand
> >>>>the wiki we have now, rather than transferring the entire site over
> >>>>to
> >>>>a different wiki system, with yet another syntax...
> >>>
> >>>There's not that much content. But we could start with just the
> >>>manual
> >>>in the new wiki, then see how we get on. The great thing about this
> >>>internet thing is we can link across websites :). So even if the old
> >>>wiki stays around for a while its no biggie
> >>>
> >>>James
> >>>-------
> >>>http://radio.weblogs.com/0112098/
> >>>
> >>
> >>
> >
> >James
> >-------
> >http://radio.weblogs.com/0112098/
> >
Installing Confluence
Posted by Dain Sundstrom <ds...@gluecode.com>.
Does anyone know where we are at with this? I am more than willing to
help.
-dain
On Jul 22, 2004, at 9:11 PM, jastrachan@mac.com wrote:
> I'm willing to help out - I just about qualify for the requirements I
> guess.
>
> On 23 Jul 2004, at 02:51, Jeff Turner wrote:
>> Would anyone else be willing to help with care and feeding of an ASF
>> Confluence instance? Requirements for the job:
>>
>> a) an ASF committer, preferably been around a few years
>> b) know how to deploy a webapp and admin a Tomcat instance
>> c) somewhat unix-savvy
>> d) willing to commit random bits of time for months to come to do
>> things
>> like upgrades
>>
>> If there's a volunteer or two, I guess the next steps would be to
>> hold a
>> (PMC-ratified) vote and send a mail off to infrastructure@ for advice.
>> They may wish to delay installation until a successor to nagoya is
>> ready.
>>
>>
>> --Jeff
>>
>> On Thu, Jul 22, 2004 at 05:11:40PM +0100, jastrachan@mac.com wrote:
>>>
>>> On 21 Jul 2004, at 17:15, Matt Kurjanowicz wrote:
>>>> Hmm, are we moving a little too fast on moving to Confluence? Like
>>>> someone said earlier, we've already switched wiki's once, and I
>>>> don't
>>>> know (beyond wiki -> xdoc) what benefits Confluence has over Wikis.
>>>
>>> Security, features, wiki language, macros for integrating with unit
>>> test code / JIRA reports - but mostly its just a nice tool to use
>>> etc.
>>>
>>> Its like saying, hey this JIRA things OK but whats wrong with
>>> bugzilla.
>>> If you've used both you'll know what I mean.
>>>
>>>
>>>> It may even be easier to update the tool (wiki->xdoc) to understand
>>>> the wiki we have now, rather than transferring the entire site over
>>>> to
>>>> a different wiki system, with yet another syntax...
>>>
>>> There's not that much content. But we could start with just the
>>> manual
>>> in the new wiki, then see how we get on. The great thing about this
>>> internet thing is we can link across websites :). So even if the old
>>> wiki stays around for a while its no biggie
>>>
>>> James
>>> -------
>>> http://radio.weblogs.com/0112098/
>>>
>>
>>
>
> James
> -------
> http://radio.weblogs.com/0112098/
>
Re: Installing Confluence [was Re: Manual]
Posted by ja...@mac.com.
I'm willing to help out - I just about qualify for the requirements I
guess.
On 23 Jul 2004, at 02:51, Jeff Turner wrote:
> Would anyone else be willing to help with care and feeding of an ASF
> Confluence instance? Requirements for the job:
>
> a) an ASF committer, preferably been around a few years
> b) know how to deploy a webapp and admin a Tomcat instance
> c) somewhat unix-savvy
> d) willing to commit random bits of time for months to come to do
> things
> like upgrades
>
> If there's a volunteer or two, I guess the next steps would be to hold
> a
> (PMC-ratified) vote and send a mail off to infrastructure@ for advice.
> They may wish to delay installation until a successor to nagoya is
> ready.
>
>
> --Jeff
>
> On Thu, Jul 22, 2004 at 05:11:40PM +0100, jastrachan@mac.com wrote:
>>
>> On 21 Jul 2004, at 17:15, Matt Kurjanowicz wrote:
>>> Hmm, are we moving a little too fast on moving to Confluence? Like
>>> someone said earlier, we've already switched wiki's once, and I don't
>>> know (beyond wiki -> xdoc) what benefits Confluence has over Wikis.
>>
>> Security, features, wiki language, macros for integrating with unit
>> test code / JIRA reports - but mostly its just a nice tool to use etc.
>>
>> Its like saying, hey this JIRA things OK but whats wrong with
>> bugzilla.
>> If you've used both you'll know what I mean.
>>
>>
>>> It may even be easier to update the tool (wiki->xdoc) to understand
>>> the wiki we have now, rather than transferring the entire site over
>>> to
>>> a different wiki system, with yet another syntax...
>>
>> There's not that much content. But we could start with just the manual
>> in the new wiki, then see how we get on. The great thing about this
>> internet thing is we can link across websites :). So even if the old
>> wiki stays around for a while its no biggie
>>
>> James
>> -------
>> http://radio.weblogs.com/0112098/
>>
>
>
James
-------
http://radio.weblogs.com/0112098/
Re: Installing Confluence [was Re: Manual]
Posted by Jeff Turner <je...@apache.org>.
Would anyone else be willing to help with care and feeding of an ASF
Confluence instance? Requirements for the job:
a) an ASF committer, preferably been around a few years
b) know how to deploy a webapp and admin a Tomcat instance
c) somewhat unix-savvy
d) willing to commit random bits of time for months to come to do things
like upgrades
If there's a volunteer or two, I guess the next steps would be to hold a
(PMC-ratified) vote and send a mail off to infrastructure@ for advice.
They may wish to delay installation until a successor to nagoya is ready.
--Jeff
On Thu, Jul 22, 2004 at 05:11:40PM +0100, jastrachan@mac.com wrote:
>
> On 21 Jul 2004, at 17:15, Matt Kurjanowicz wrote:
> >Hmm, are we moving a little too fast on moving to Confluence? Like
> >someone said earlier, we've already switched wiki's once, and I don't
> >know (beyond wiki -> xdoc) what benefits Confluence has over Wikis.
>
> Security, features, wiki language, macros for integrating with unit
> test code / JIRA reports - but mostly its just a nice tool to use etc.
>
> Its like saying, hey this JIRA things OK but whats wrong with bugzilla.
> If you've used both you'll know what I mean.
>
>
> >It may even be easier to update the tool (wiki->xdoc) to understand
> >the wiki we have now, rather than transferring the entire site over to
> >a different wiki system, with yet another syntax...
>
> There's not that much content. But we could start with just the manual
> in the new wiki, then see how we get on. The great thing about this
> internet thing is we can link across websites :). So even if the old
> wiki stays around for a while its no biggie
>
> James
> -------
> http://radio.weblogs.com/0112098/
>
Re: Installing Confluence [was Re: Manual]
Posted by Serge Knystautas <se...@lokitech.com>.
Matt Kurjanowicz wrote:
> Ok, you've all convinced me of my error :). Well in that case I'd be
> more than happy to help move stuff over to Confluence. I didn't
> realize that confluence had so many security features beyond the wiki
> we use now.
What I am most excited about with Confluence is that you can export the
content into HTML or PDF format (probably others). IMHO one of the best
things about the Hibernate project is that they use their wiki to
generate documentation (cowiki), and then they export and include all
that into their releases.
--
Serge Knystautas
Lokitech >> software . strategy . design >> http://www.lokitech.com
p. 301.656.5501
e. sergek@lokitech.com
Re: Installing Confluence [was Re: Manual]
Posted by Matt Kurjanowicz <ma...@gmail.com>.
Ok, you've all convinced me of my error :). Well in that case I'd be
more than happy to help move stuff over to Confluence. I didn't
realize that confluence had so many security features beyond the wiki
we use now.
Thanks,
Matt Kurjanowicz
On Thu, 22 Jul 2004 17:11:40 +0100, jastrachan@mac.com
<ja...@mac.com> wrote:
>
> On 21 Jul 2004, at 17:15, Matt Kurjanowicz wrote:
> > Hmm, are we moving a little too fast on moving to Confluence? Like
> > someone said earlier, we've already switched wiki's once, and I don't
> > know (beyond wiki -> xdoc) what benefits Confluence has over Wikis.
>
> Security, features, wiki language, macros for integrating with unit
> test code / JIRA reports - but mostly its just a nice tool to use etc.
>
> Its like saying, hey this JIRA things OK but whats wrong with bugzilla.
> If you've used both you'll know what I mean.
>
>
> > It may even be easier to update the tool (wiki->xdoc) to understand
> > the wiki we have now, rather than transferring the entire site over to
> > a different wiki system, with yet another syntax...
>
> There's not that much content. But we could start with just the manual
> in the new wiki, then see how we get on. The great thing about this
> internet thing is we can link across websites :). So even if the old
> wiki stays around for a while its no biggie
>
>
>
> James
> -------
> http://radio.weblogs.com/0112098/
>
>
--
Matthew Kurjanowicz
matt.kurjanowicz@gmail.com
The Readme Plugin
http://projassist.sourceforge.net/readme-plugin/
The Projassist Project
* Making Bug-Tracking Easy *
http://projassist.sourceforge.net/
Re: Installing Confluence [was Re: Manual]
Posted by ja...@mac.com.
On 21 Jul 2004, at 17:15, Matt Kurjanowicz wrote:
> Hmm, are we moving a little too fast on moving to Confluence? Like
> someone said earlier, we've already switched wiki's once, and I don't
> know (beyond wiki -> xdoc) what benefits Confluence has over Wikis.
Security, features, wiki language, macros for integrating with unit
test code / JIRA reports - but mostly its just a nice tool to use etc.
Its like saying, hey this JIRA things OK but whats wrong with bugzilla.
If you've used both you'll know what I mean.
> It may even be easier to update the tool (wiki->xdoc) to understand
> the wiki we have now, rather than transferring the entire site over to
> a different wiki system, with yet another syntax...
There's not that much content. But we could start with just the manual
in the new wiki, then see how we get on. The great thing about this
internet thing is we can link across websites :). So even if the old
wiki stays around for a while its no biggie
James
-------
http://radio.weblogs.com/0112098/
Re: Installing Confluence [was Re: Manual]
Posted by David Blevins <da...@visi.com>.
Dunno, was asking hoping someone with confluence knowledge would pipe in.
-David
On Wed, Jul 21, 2004 at 09:28:12PM -0400, Matthew Kurjanowicz wrote:
> Point taken :) However, isn't Confluence the same as all wikis where
> anyone can edit the pages? One can require that people create accounts
> to edit the wiki, but doesn't it need to be unlocked now anyways?
> Thanks,
> -Matt Kurjanowicz
>
> On Jul 21, 2004, at 9:19 PM, David Blevins wrote:
>
> >Will Confluence spare us the embarrassment of having our wiki data
> >replaced with offensive ASCII "art" when we are mentioned on
> >slashdot?
> >
> >If so, that's more than enough reason to switch IMO.
> >
> >-David
> >
> >On Wed, Jul 21, 2004 at 12:15:39PM -0400, Matt Kurjanowicz wrote:
> >>Hmm, are we moving a little too fast on moving to Confluence? Like
> >>someone said earlier, we've already switched wiki's once, and I don't
> >>know (beyond wiki -> xdoc) what benefits Confluence has over Wikis.
> >>It may even be easier to update the tool (wiki->xdoc) to understand
> >>the wiki we have now, rather than transferring the entire site over to
> >>a different wiki system, with yet another syntax...
> >>Just my $0.02.
> >>-Matt Kurjanowicz
> >>
> >>On Wed, 21 Jul 2004 09:27:49 -0400, Serge Knystautas
> >><se...@lokitech.com> wrote:
> >>>
> >>>
> >>>jastrachan@mac.com wrote:
> >>>>>I personally think the wiki is the best place to develop
> >>>>>documentation, because everyone can participate. The issue is our
> >>>>>wiki software is... lets say difficult. James Strachan has a neat
> >>>>>utility for Confluence wiki, which Codehaus uses, that converts the
> >>>>>wiki markup to html, pdf and runs all the test cases coded into the
> >>>>>wiki. I would like to follow a similar route for our docs where we
> >>>>>develop them on the wiki and regularly stamp them and check them
> >>>>>into
> >>>>>the project xdocs.
> >>>>>
> >>>>>Does anyone know what we need to do to get Confluence running at
> >>>>>Apache?
> >>>>
> >>>>JiraMike was saying at JavaOne that there's a guy at Atlassian
> >>>>who's an
> >>>>apache member who'd be willing to help make this happen. I'd
> >>>>consumed a
> >>>>fair bit of alcohol at this point and I think it was Jeff right?
> >>>>
> >>>>Mike / Jeff care to help us out?
> >>>
> >>>Atlassian is incredibly supportive of the ASF, and it takes nothing
> >>>from
> >>>them. We just need someone to volunteer to install and maintain it
> >>>(like I did for JIRA). I'd be interested in helping with Confluence
> >>>as
> >>>well.
> >>>
> >>>However, I've been really busy this summer and slacking off helping
> >>>with
> >>>JIRA, so if someone wants to volunteer to get Confluence going and
> >>>help,
> >>>that's all it'll take.
> >>>
> >>>--
> >>>Serge Knystautas
> >>>Lokitech >> software . strategy . design >> http://www.lokitech.com
> >>>p. 301.656.5501
> >>>e. sergek@lokitech.com
> >>>
> >>
> >>
> >>--
> >>Matthew Kurjanowicz
> >>matt.kurjanowicz@gmail.com
> >>The Readme Plugin
> >>http://projassist.sourceforge.net/readme-plugin/
> >>
> >>The Projassist Project
> >>* Making Bug-Tracking Easy *
> >>http://projassist.sourceforge.net/
Re: Installing Confluence [was Re: Manual]
Posted by ja...@mac.com.
On 22 Jul 2004, at 02:28, Matthew Kurjanowicz wrote:
> Point taken :) However, isn't Confluence the same as all wikis where
> anyone can edit the pages? One can require that people create
> accounts to edit the wiki, but doesn't it need to be unlocked now
> anyways?
There are various options - its easy to change the permissions.
Many Confluence wiki's I create tend to have permissions for anyone
who's registered with confluence to edit pages (to encourage
involvement) & anyone to view.
Though often folks only allow 'committers' (in the wiki not CVS sense)
permissions to edit pages but allow anyone who's registered to comment
on pages. Maybe the latter - along with a low barrier of entry (let
people have write access when they ask for it, then reject it when they
mess up) is a middle ground.
James
-------
http://radio.weblogs.com/0112098/
Re: Installing Confluence [was Re: Manual]
Posted by Matthew Kurjanowicz <mk...@cc.gatech.edu>.
Point taken :) However, isn't Confluence the same as all wikis where
anyone can edit the pages? One can require that people create accounts
to edit the wiki, but doesn't it need to be unlocked now anyways?
Thanks,
-Matt Kurjanowicz
On Jul 21, 2004, at 9:19 PM, David Blevins wrote:
> Will Confluence spare us the embarrassment of having our wiki data
> replaced with offensive ASCII "art" when we are mentioned on
> slashdot?
>
> If so, that's more than enough reason to switch IMO.
>
> -David
>
> On Wed, Jul 21, 2004 at 12:15:39PM -0400, Matt Kurjanowicz wrote:
>> Hmm, are we moving a little too fast on moving to Confluence? Like
>> someone said earlier, we've already switched wiki's once, and I don't
>> know (beyond wiki -> xdoc) what benefits Confluence has over Wikis.
>> It may even be easier to update the tool (wiki->xdoc) to understand
>> the wiki we have now, rather than transferring the entire site over to
>> a different wiki system, with yet another syntax...
>> Just my $0.02.
>> -Matt Kurjanowicz
>>
>> On Wed, 21 Jul 2004 09:27:49 -0400, Serge Knystautas
>> <se...@lokitech.com> wrote:
>>>
>>>
>>> jastrachan@mac.com wrote:
>>>>> I personally think the wiki is the best place to develop
>>>>> documentation, because everyone can participate. The issue is our
>>>>> wiki software is... lets say difficult. James Strachan has a neat
>>>>> utility for Confluence wiki, which Codehaus uses, that converts the
>>>>> wiki markup to html, pdf and runs all the test cases coded into the
>>>>> wiki. I would like to follow a similar route for our docs where we
>>>>> develop them on the wiki and regularly stamp them and check them
>>>>> into
>>>>> the project xdocs.
>>>>>
>>>>> Does anyone know what we need to do to get Confluence running at
>>>>> Apache?
>>>>
>>>> JiraMike was saying at JavaOne that there's a guy at Atlassian
>>>> who's an
>>>> apache member who'd be willing to help make this happen. I'd
>>>> consumed a
>>>> fair bit of alcohol at this point and I think it was Jeff right?
>>>>
>>>> Mike / Jeff care to help us out?
>>>
>>> Atlassian is incredibly supportive of the ASF, and it takes nothing
>>> from
>>> them. We just need someone to volunteer to install and maintain it
>>> (like I did for JIRA). I'd be interested in helping with Confluence
>>> as
>>> well.
>>>
>>> However, I've been really busy this summer and slacking off helping
>>> with
>>> JIRA, so if someone wants to volunteer to get Confluence going and
>>> help,
>>> that's all it'll take.
>>>
>>> --
>>> Serge Knystautas
>>> Lokitech >> software . strategy . design >> http://www.lokitech.com
>>> p. 301.656.5501
>>> e. sergek@lokitech.com
>>>
>>
>>
>> --
>> Matthew Kurjanowicz
>> matt.kurjanowicz@gmail.com
>> The Readme Plugin
>> http://projassist.sourceforge.net/readme-plugin/
>>
>> The Projassist Project
>> * Making Bug-Tracking Easy *
>> http://projassist.sourceforge.net/
Re: Installing Confluence [was Re: Manual]
Posted by ja...@mac.com.
On 22 Jul 2004, at 02:19, David Blevins wrote:
> Will Confluence spare us the embarrassment of having our wiki data
> replaced with offensive ASCII "art" when we are mentioned on
> slashdot?
Yes! Restrict posts to folks who've logged in & registered with a valid
email address, rather than just any old spammer. Or force a moderator
to let you on if you're really keen
> If so, that's more than enough reason to switch IMO.
Agreed!
Plus its easy to subscribe to RSS feeds of pages changed, comments
added and so forth.
James
-------
http://radio.weblogs.com/0112098/
Re: Installing Confluence [was Re: Manual]
Posted by David Blevins <da...@visi.com>.
Will Confluence spare us the embarrassment of having our wiki data
replaced with offensive ASCII "art" when we are mentioned on
slashdot?
If so, that's more than enough reason to switch IMO.
-David
On Wed, Jul 21, 2004 at 12:15:39PM -0400, Matt Kurjanowicz wrote:
> Hmm, are we moving a little too fast on moving to Confluence? Like
> someone said earlier, we've already switched wiki's once, and I don't
> know (beyond wiki -> xdoc) what benefits Confluence has over Wikis.
> It may even be easier to update the tool (wiki->xdoc) to understand
> the wiki we have now, rather than transferring the entire site over to
> a different wiki system, with yet another syntax...
> Just my $0.02.
> -Matt Kurjanowicz
>
> On Wed, 21 Jul 2004 09:27:49 -0400, Serge Knystautas
> <se...@lokitech.com> wrote:
> >
> >
> > jastrachan@mac.com wrote:
> > >> I personally think the wiki is the best place to develop
> > >> documentation, because everyone can participate. The issue is our
> > >> wiki software is... lets say difficult. James Strachan has a neat
> > >> utility for Confluence wiki, which Codehaus uses, that converts the
> > >> wiki markup to html, pdf and runs all the test cases coded into the
> > >> wiki. I would like to follow a similar route for our docs where we
> > >> develop them on the wiki and regularly stamp them and check them into
> > >> the project xdocs.
> > >>
> > >> Does anyone know what we need to do to get Confluence running at Apache?
> > >
> > > JiraMike was saying at JavaOne that there's a guy at Atlassian who's an
> > > apache member who'd be willing to help make this happen. I'd consumed a
> > > fair bit of alcohol at this point and I think it was Jeff right?
> > >
> > > Mike / Jeff care to help us out?
> >
> > Atlassian is incredibly supportive of the ASF, and it takes nothing from
> > them. We just need someone to volunteer to install and maintain it
> > (like I did for JIRA). I'd be interested in helping with Confluence as
> > well.
> >
> > However, I've been really busy this summer and slacking off helping with
> > JIRA, so if someone wants to volunteer to get Confluence going and help,
> > that's all it'll take.
> >
> > --
> > Serge Knystautas
> > Lokitech >> software . strategy . design >> http://www.lokitech.com
> > p. 301.656.5501
> > e. sergek@lokitech.com
> >
>
>
> --
> Matthew Kurjanowicz
> matt.kurjanowicz@gmail.com
> The Readme Plugin
> http://projassist.sourceforge.net/readme-plugin/
>
> The Projassist Project
> * Making Bug-Tracking Easy *
> http://projassist.sourceforge.net/
Re: Installing Confluence [was Re: Manual]
Posted by Matt Kurjanowicz <ma...@gmail.com>.
Hmm, are we moving a little too fast on moving to Confluence? Like
someone said earlier, we've already switched wiki's once, and I don't
know (beyond wiki -> xdoc) what benefits Confluence has over Wikis.
It may even be easier to update the tool (wiki->xdoc) to understand
the wiki we have now, rather than transferring the entire site over to
a different wiki system, with yet another syntax...
Just my $0.02.
-Matt Kurjanowicz
On Wed, 21 Jul 2004 09:27:49 -0400, Serge Knystautas
<se...@lokitech.com> wrote:
>
>
> jastrachan@mac.com wrote:
> >> I personally think the wiki is the best place to develop
> >> documentation, because everyone can participate. The issue is our
> >> wiki software is... lets say difficult. James Strachan has a neat
> >> utility for Confluence wiki, which Codehaus uses, that converts the
> >> wiki markup to html, pdf and runs all the test cases coded into the
> >> wiki. I would like to follow a similar route for our docs where we
> >> develop them on the wiki and regularly stamp them and check them into
> >> the project xdocs.
> >>
> >> Does anyone know what we need to do to get Confluence running at Apache?
> >
> > JiraMike was saying at JavaOne that there's a guy at Atlassian who's an
> > apache member who'd be willing to help make this happen. I'd consumed a
> > fair bit of alcohol at this point and I think it was Jeff right?
> >
> > Mike / Jeff care to help us out?
>
> Atlassian is incredibly supportive of the ASF, and it takes nothing from
> them. We just need someone to volunteer to install and maintain it
> (like I did for JIRA). I'd be interested in helping with Confluence as
> well.
>
> However, I've been really busy this summer and slacking off helping with
> JIRA, so if someone wants to volunteer to get Confluence going and help,
> that's all it'll take.
>
> --
> Serge Knystautas
> Lokitech >> software . strategy . design >> http://www.lokitech.com
> p. 301.656.5501
> e. sergek@lokitech.com
>
--
Matthew Kurjanowicz
matt.kurjanowicz@gmail.com
The Readme Plugin
http://projassist.sourceforge.net/readme-plugin/
The Projassist Project
* Making Bug-Tracking Easy *
http://projassist.sourceforge.net/
Re: Installing Confluence [was Re: Manual]
Posted by Serge Knystautas <se...@lokitech.com>.
jastrachan@mac.com wrote:
>> I personally think the wiki is the best place to develop
>> documentation, because everyone can participate. The issue is our
>> wiki software is... lets say difficult. James Strachan has a neat
>> utility for Confluence wiki, which Codehaus uses, that converts the
>> wiki markup to html, pdf and runs all the test cases coded into the
>> wiki. I would like to follow a similar route for our docs where we
>> develop them on the wiki and regularly stamp them and check them into
>> the project xdocs.
>>
>> Does anyone know what we need to do to get Confluence running at Apache?
>
> JiraMike was saying at JavaOne that there's a guy at Atlassian who's an
> apache member who'd be willing to help make this happen. I'd consumed a
> fair bit of alcohol at this point and I think it was Jeff right?
>
> Mike / Jeff care to help us out?
Atlassian is incredibly supportive of the ASF, and it takes nothing from
them. We just need someone to volunteer to install and maintain it
(like I did for JIRA). I'd be interested in helping with Confluence as
well.
However, I've been really busy this summer and slacking off helping with
JIRA, so if someone wants to volunteer to get Confluence going and help,
that's all it'll take.
--
Serge Knystautas
Lokitech >> software . strategy . design >> http://www.lokitech.com
p. 301.656.5501
e. sergek@lokitech.com
Installing Confluence [was Re: Manual]
Posted by ja...@mac.com.
On 21 Jul 2004, at 04:02, Dain Sundstrom wrote:
> I personally think the wiki is the best place to develop
> documentation, because everyone can participate. The issue is our
> wiki software is... lets say difficult. James Strachan has a neat
> utility for Confluence wiki, which Codehaus uses, that converts the
> wiki markup to html, pdf and runs all the test cases coded into the
> wiki. I would like to follow a similar route for our docs where we
> develop them on the wiki and regularly stamp them and check them into
> the project xdocs.
>
> Does anyone know what we need to do to get Confluence running at
> Apache?
JiraMike was saying at JavaOne that there's a guy at Atlassian who's an
apache member who'd be willing to help make this happen. I'd consumed a
fair bit of alcohol at this point and I think it was Jeff right?
Mike / Jeff care to help us out?
James
-------
http://radio.weblogs.com/0112098/
Re: Manual
Posted by Dain Sundstrom <da...@coredevelopers.net>.
I personally think the wiki is the best place to develop documentation,
because everyone can participate. The issue is our wiki software is...
lets say difficult. James Strachan has a neat utility for Confluence
wiki, which Codehaus uses, that converts the wiki markup to html, pdf
and runs all the test cases coded into the wiki. I would like to
follow a similar route for our docs where we develop them on the wiki
and regularly stamp them and check them into the project xdocs.
Does anyone know what we need to do to get Confluence running at Apache?
-dain
On Jul 20, 2004, at 2:46 PM, Aaron Mulder wrote:
> I think I'm climbing out from under my rock, at least a little
> bit, and I'd like to start work on a manual. If I can produce a HTML
> version, what's the best way to get it included on the
> geronimo.apache.org
> web site? I'm thinking we should add a Documentation link to the left
> navigation bar (probably under the "Geronimo" header) and then on that
> page include a link to the HTML manual as well as to the Maven FAQ and
> perhaps a couple Wiki links to flesh it out.
>
> Thanks,
> Aaron
Re: Manual
Posted by Matthew Kurjanowicz <mk...@cc.gatech.edu>.
Bruce, If I can help with the book (editing, etc.) at all let me know -
I'd love to help any way I can.
Aaron: why not make it a subdir under xdocs. Unfortunately this can be
way too static, but on the other hand it will look like the rest of the
website. Each page can be a simple XML document like index.xml. That
way all the links (to the Wiki, all the other available documentation)
will be available. PDFs can be generated using the Maven PDF plugin,
including any other site documentation that is useful, such as changes,
wiki, issues, etc. I'm pretrty sure there's a plugin somewhere to turn
Wikis into XML docs for just this purpose.
Just my $0.02.
-Matt Kurjanowicz
On Jul 20, 2004, at 7:43 PM, Bruce Snyder wrote:
> Aaron Mulder wrote:
>
>> I think I'm climbing out from under my rock, at least a little bit,
>> and I'd like to start work on a manual. If I can produce a HTML
>> version, what's the best way to get it included on the
>> geronimo.apache.org web site? I'm thinking we should add a
>> Documentation link to the left navigation bar (probably under the
>> "Geronimo" header) and then on that page include a link to the HTML
>> manual as well as to the Maven FAQ and perhaps a couple Wiki links to
>> flesh it out.
>
> FYI, I will be starting the Geronimom Live book in either August or
> September for SourceBeat Publishing. Chapter 1 of this book will be a
> Quick Start Guide that I'm planning to donate back to the project.
> This will be the first chapter I write. It will be in PDF form so we
> can include a link to it from the Geronimo site as well.
>
> Bruce
> --
> perl -e 'print
> unpack("u30","<0G)U8V4\\@4VYY9&5R\\"F9E<G)E=\\$\\!F<FEI+F-O;0\\`\\
> `");'
>
> The Castor Project
> http://www.castor.org/
>
> Apache Geronimo
> http://incubator.apache.org/projects/geronimo.html
Re: Manual
Posted by Bruce Snyder <fe...@frii.com>.
Aaron Mulder wrote:
> I think I'm climbing out from under my rock, at least a little
> bit, and I'd like to start work on a manual. If I can produce a HTML
> version, what's the best way to get it included on the geronimo.apache.org
> web site? I'm thinking we should add a Documentation link to the left
> navigation bar (probably under the "Geronimo" header) and then on that
> page include a link to the HTML manual as well as to the Maven FAQ and
> perhaps a couple Wiki links to flesh it out.
FYI, I will be starting the Geronimom Live book in either August or
September for SourceBeat Publishing. Chapter 1 of this book will be a
Quick Start Guide that I'm planning to donate back to the project. This
will be the first chapter I write. It will be in PDF form so we can
include a link to it from the Geronimo site as well.
Bruce
--
perl -e 'print
unpack("u30","<0G)U8V4\\@4VYY9&5R\\"F9E<G)E=\\$\\!F<FEI+F-O;0\\`\\`");'
The Castor Project
http://www.castor.org/
Apache Geronimo
http://incubator.apache.org/projects/geronimo.html
Re: Manual
Posted by Antonio Gallardo <ag...@agssa.net>.
Aaron Mulder dijo:
> I think I'm climbing out from under my rock, at least a little
> bit, and I'd like to start work on a manual. If I can produce a HTML
> version, what's the best way to get it included on the geronimo.apache.org
> web site? I'm thinking we should add a Documentation link to the left
> navigation bar (probably under the "Geronimo" header) and then on that
> page include a link to the HTML manual as well as to the Maven FAQ and
> perhaps a couple Wiki links to flesh it out.
Hmm. Perhaps using apache forrest:
http://forrest.apache.org/
That way the manual will be in XML and easily rendered to what ever: HTML,
PDF, etc.
WDYT?
Best Regards,
Antonio Gallardo