Re: Confluence Setup

2005-12-05 Thread John Sisson

Jason Dillon wrote:


Is there a way we can set the footer on every page to say that any
content contributed to the Wiki is under the ASL 2.0 license, with a
link to the license, or have a notice on the edit page?   Documentation
contributions should not be any different to code contributions.



Agreed, I'm sure there's a way to set a footer containing the license.



If someone can give me the text that should be on the footer I can  
easily add that to all pages in all spaces.


--jason


I am not a lawyer...  Something along the lines of (roughly based upon 
statement in attachment page in JIRA)..


Contributions of content on the Geronimo Wiki imply a grant of license 
to the ASF for inclusion in ASF works (as per the Apache Software 
License, Version 2.0 ยง5)


The above would have a link to the 2.0 license page.

Should this be checked on legal-discuss?

John


Re: Confluence Setup

2005-12-05 Thread Jason Dillon

Is there a way we can set the footer on every page to say that any
content contributed to the Wiki is under the ASL 2.0 license, with a
link to the license, or have a notice on the edit page?   
Documentation

contributions should not be any different to code contributions.


Agreed, I'm sure there's a way to set a footer containing the license.


If someone can give me the text that should be on the footer I can  
easily add that to all pages in all spaces.


--jason



Re: Confluence Setup

2005-12-05 Thread Jason Dillon

FYI, I imported the GERONIMO space from:

http://opensource2.atlassian.com/confluence/oss/display/ 
GERONIMO/ Home


Are we allowed to run this in the zone?  It would be nice to get  
confirmation of this (how I don't know) as I don't think users will  
be happy if they contribute to it and then have the rug pulled from  
under their feet.


Officially... I do not know.  So far no one has asked me to take it  
down.




Any suggestions or recommendations?

We need to have a strategy on how we are going manage reviewing,  
removing out of date content, and moving valid content from the  
existing Wiki.  A lot of the existing content is out of date or  
irrelevant.  We need to be careful that we don't end up having two  
half baked Wikis for Geronimo.


Agreed.  I was surprised to see that my test of a wiki voting system  
was still up there... and on the frontpage even.


One thing that I really like about Confluence in comparison to other  
wiki systems is its ability to easily move pages around and delete  
pages to the trash.  This really helps improve the ability to  
refactor the wiki content and structure as needs change.


 Maybe ApacheCon would be a good opportunity to get everyone  
together and review the content in the existing Wiki.  IMHO, if we  
don't have accurate documentation for the 1.0 release then we  
should reconsidering the release (we kind of had an excuse for  
milestone releases, 1.0 should be a step up in quality from  
milestones.. users will have expectations of quality).


Ya, defs talk it up, but as someone already mentioned not everyone  
will be at ApacheCon, so bring it back to the list plz :-)


The site shows we are using an Evaluation License.  We should have  
a full license if we are relying upon it.


I've requested an open source license from Atlassian, still pending  
an answer from them.


Is there a way we can set the footer on every page to say that any  
content contributed to the Wiki is under the ASL 2.0 license, with  
a link to the license, or have a notice on the edit page?   
Documentation contributions should not be any different to code  
contributions.


Yes, its trivial to alter the footer.

I was also thinking of adding a simple glossary and knowledge- 
base  space and/or faq space, that would auto-generate listings  
for pages  added and provide simple navigation (similar to http://  
confluence.atlassian.com/display/DISC/Home).


I am not that familiar with Confluence, but it appears that the URL  
above hosts discussions.  Do we really want to encourage users to  
have discussions in places other than the mailing lists?


I'm not sure exactly what you are referring too.  Confluence is not a  
forum, but it does have support for user comment threads, where  
registered/anonymous users can add their .02 to a page.  I think this  
is very useful, especially for documentation.  We don't want to open  
up the pristine docs to let any user change them, but we want them to  
have some input too.  This is sorta like how the docs work at  
php.net.  There is a page that describes a feature, and then users  
can comment on the page.  I have found that more often than not, then  
comments are more useful than the documentation.


I would however limit this to just comments and not discussion,  
as it sometimes ends up to be on Atlassian's main Confluence site.


Anyways, with a little bit of oversight and active enforcement it is  
really easy to keep things in check.


If we could import all of Geronimo's mail archives into its  
searchable mail interface... that sounds powerful as they say it is  
fully indexed and searchable with your other content.


http://www.atlassian.com/software/confluence/features/mail.jsp

IMHO we don't want users having to search in two different places  
to find information.


Yes, Confluence can archive email, which does make Confluence a nice  
single place to search for information.  Though, the list archiving  
is still a bit crude IMO.


--jason



Re: Confluence Setup

2005-12-05 Thread Hernan Cunico


Bruce Snyder wrote:

On 12/5/05, Hernan Cunico <[EMAIL PROTECTED]> wrote:



We need to have a strategy on how we are going manage reviewing,
removing out of date content, and moving valid content from the existing
Wiki.  A lot of the existing content is out of date or irrelevant.  We
need to be careful that we don't end up having two half baked Wikis for
Geronimo.


Totally agree, should "focal points" for documentation be identified for
gathering/addressing all the doc strategy related stuff? or maybe a
structure similar to "contributors and committers" should be in place
for documentation!?



Hernan, some of us raised this point earlier this year - the notion
that there will be committers who don't necessarily write code but
instead write documentation or do other things. I'd like to raise this
discussion again because, IMO, the ultimate way to write documentation
is in a format that can be easily converted to just about anything
else including a wiki. My reason for feeling this way is so that the
docs are versioned with the code and so that the docs are tracked via
the same mechanism as the code.


Agree with you with using a format easy to export from and with the 
versioning. In addition, using committers will provide a way to control 
the content (as with the code) for accuracy, helping to keep the 
documentation "official".


We somehow have to be able to guarantee the content is accurate and 
updated for a given version. Using contributors/committers would be one 
way to achieve this.



Maybe ApacheCon would be a good opportunity to get everyone together and
review the content in the existing Wiki.  IMHO, if we don't have


Guys, keep in mind that not everybody is going to ApacheCon, pls keep
the dev list updated with your discussions on this.



No problem here, Hernan. The Apache Way is to do as close to 100% of
the discussion, decision making, etc. on the mailing lists so that
nobody is excluded.


Face-to-face discussions are faster, wider and have lots of other 
benefits. When writing them, at least in my case, one tries to summarize 
the key items (that is a fact) and some times, some details are lost. My 
comment meant to be just a "friendly reminder" on the discussions ;)


Cheers!
Hernan


Bruce
--
perl -e 'print unpack("u30","D0G)[EMAIL 
PROTECTED]&5R\"F)R=6-E+G-N>61Ehttp://www.castor.org/

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



Re: Confluence Setup

2005-12-05 Thread Bruce Snyder
On 12/5/05, Hernan Cunico <[EMAIL PROTECTED]> wrote:

> > We need to have a strategy on how we are going manage reviewing,
> > removing out of date content, and moving valid content from the existing
> > Wiki.  A lot of the existing content is out of date or irrelevant.  We
> > need to be careful that we don't end up having two half baked Wikis for
> > Geronimo.
> Totally agree, should "focal points" for documentation be identified for
> gathering/addressing all the doc strategy related stuff? or maybe a
> structure similar to "contributors and committers" should be in place
> for documentation!?

Hernan, some of us raised this point earlier this year - the notion
that there will be committers who don't necessarily write code but
instead write documentation or do other things. I'd like to raise this
discussion again because, IMO, the ultimate way to write documentation
is in a format that can be easily converted to just about anything
else including a wiki. My reason for feeling this way is so that the
docs are versioned with the code and so that the docs are tracked via
the same mechanism as the code.

> > Maybe ApacheCon would be a good opportunity to get everyone together and
> > review the content in the existing Wiki.  IMHO, if we don't have
> Guys, keep in mind that not everybody is going to ApacheCon, pls keep
> the dev list updated with your discussions on this.

No problem here, Hernan. The Apache Way is to do as close to 100% of
the discussion, decision making, etc. on the mailing lists so that
nobody is excluded.

Bruce
--
perl -e 'print unpack("u30","D0G)[EMAIL 
PROTECTED]&5R\"F)R=6-E+G-N>61Ehttp://www.castor.org/

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


Re: Confluence Setup

2005-12-05 Thread Hernan Cunico

Hi All,
See some comments inline.

John Sisson wrote:

Jason Dillon wrote:

...
I'm not sure that we need a separate user vs. admin guide right  
now... so perhaps we can just collect all of the documentation into a  
DOC10 or GUIDE10 space or something.


Any suggestions or recommendations?

We need to have a strategy on how we are going manage reviewing, 
removing out of date content, and moving valid content from the existing 
Wiki.  A lot of the existing content is out of date or irrelevant.  We 
need to be careful that we don't end up having two half baked Wikis for 
Geronimo.
Totally agree, should "focal points" for documentation be identified for 
gathering/addressing all the doc strategy related stuff? or maybe a 
structure similar to "contributors and committers" should be in place 
for documentation!?
Maybe ApacheCon would be a good opportunity to get everyone together and 
review the content in the existing Wiki.  IMHO, if we don't have 
Guys, keep in mind that not everybody is going to ApacheCon, pls keep 
the dev list updated with your discussions on this.
accurate documentation for the 1.0 release then we should reconsidering 
the release (we kind of had an excuse for milestone releases, 1.0 should 
be a step up in quality from milestones.. users will have expectations 
of quality).
Does anyone have any docs/info that would like to include in the 
confuence site? If later it is decided that confluence is an absolute 
"no go" then we can still migrate that info out but at least we would 
have all the doc consolidated in one place to migrate from.


The site shows we are using an Evaluation License.  We should have a 
full license if we are relying upon it.
I would guess this will be fixed once the decision of supporting a 
locally hosted confluence site is taken.


Is there a way we can set the footer on every page to say that any 
content contributed to the Wiki is under the ASL 2.0 license, with a 
link to the license, or have a notice on the edit page?  Documentation 
contributions should not be any different to code contributions.
We had this discussion before, being a confluence admin this is really 
easy to achive by editing the current template. It should not take more 
than a two mins.


I was also thinking of adding a simple glossary and knowledge-base  
space and/or faq space, that would auto-generate listings for pages  
added and provide simple navigation (similar to http:// 
confluence.atlassian.com/display/DISC/Home).



I am not that familiar with Confluence, but it appears that the URL 
above hosts discussions.  Do we really want to encourage users to have 
discussions in places other than the mailing lists?  If we could import 
all of Geronimo's mail archives into its searchable mail interface... 
that sounds powerful as they say it is fully indexed and searchable with 
your other content.


http://www.atlassian.com/software/confluence/features/mail.jsp

IMHO we don't want users having to search in two different places to 
find information.
I believe that keeping the things simple is the key. Having too many 
options on the front page may (and probaly will) cause a negative effect 
in the user.
Users getting to this (future) page is because they have a 
question/problem that needs to be quickly resolved. Getting to the 
answer should be as easy/simple as possible.


As for the mail list discussions, there has to be a way to let the users 
know which "results" are official and which are not (i.e. other users reply)


Hernan


John



--jason


Re: Confluence Setup

2005-12-05 Thread Bruce Snyder
On 12/5/05, Matt Hogstrom <[EMAIL PROTECTED]> wrote:

> Not to volunteer anyone (;-0) but Hernan seems to be the documentation master
> these days.   Perhaps he'd be interested ?

Actually, Matt just after I sent my previous reply, I thought of
exactly the same thing. Let's ping him to query his interest. (I'm
CC'ing him on this response.)

> Also, I'm not sure stale is worse than no content.  If its stale at least its 
> a
> starting point.  If there is nothing to start with you have to mine the code 
> or
> mailing list.

Possibly, depends on the amount of staleness we're talking about.

Bruce
--
perl -e 'print unpack("u30","D0G)[EMAIL 
PROTECTED]&5R\"F)R=6-E+G-N>61Ehttp://www.castor.org/

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


Re: Confluence Setup

2005-12-05 Thread Matt Hogstrom
lanet57.com> <[EMAIL PROTECTED]> <[EMAIL PROTECTED]> <[EMAIL 
PROTECTED]> <[EMAIL PROTECTED]> <[EMAIL PROTECTED]
il.com> <[EMAIL PROTECTED]>
In-Reply-To: <[EMAIL PROTECTED]>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-MMS-Smtp-Program: Macallan-Mail-Solution; Version 4.6.0.1
X-MMS-Smtp-Auth: Authenticated As [EMAIL PROTECTED]
X-MMS-Smtp-Mailer-Program: Macallan-Mail-Solution; Version 4.6.0.1

Not to volunteer anyone (;-0) but Hernan seems to be the documentation master 
these days.   Perhaps he'd be interested ?

Also, I'm not sure stale is worse than no content.  If its stale at least its a 
starting point.  If there is nothing to start with you have to mine the code or 
mailing list.

The best solution is current doc that is wrangled though.

Matt

Bruce Snyder wrote:
> On 12/5/05, John Sisson <[EMAIL PROTECTED]> wrote:
> 
> 
>>We need to have a strategy on how we are going manage reviewing,
>>removing out of date content, and moving valid content from the existing
>>Wiki.  A lot of the existing content is out of date or irrelevant.  We
>>need to be careful that we don't end up having two half baked Wikis for
>>Geronimo.
> 
> 
> I agree John. Allowing stale content to remain is worse than having no
> content at all. What we really need is for someone to own the online
> content and serve as a wrangler for it. And, no, I am not volunteering
> ;-) (I certainly see the need but I don't have the time).
> 
> 
>>Maybe ApacheCon would be a good opportunity to get everyone together and
>>review the content in the existing Wiki.  IMHO, if we don't have
>>accurate documentation for the 1.0 release then we should reconsidering
>>the release (we kind of had an excuse for milestone releases, 1.0 should
>>be a step up in quality from milestones.. users will have expectations
>>of quality).
> 
> 
> Good point, let's plan on discussing this over the weekend at ApacheCon.
> 
> 
>>The site shows we are using an Evaluation License.  We should have a
>>full license if we are relying upon it.
> 
> 
> Jason said he was working to get the open source license.
> 
> 
>>Is there a way we can set the footer on every page to say that any
>>content contributed to the Wiki is under the ASL 2.0 license, with a
>>link to the license, or have a notice on the edit page?  Documentation
>>contributions should not be any different to code contributions.
> 
> 
> Agreed, I'm sure there's a way to set a footer containing the license.
> 
> Bruce
> --
> perl -e 'print unpack("u30","D0G)[EMAIL 
> PROTECTED]&5R\"F)R=6-E+G-N>61E );'
> 
> The Castor Project
> http://www.castor.org/
> 
> Apache Geronimo
> http://geronimo.apache.org/
> 
> 
> 



Re: Confluence Setup

2005-12-05 Thread Bruce Snyder
On 12/5/05, John Sisson <[EMAIL PROTECTED]> wrote:

> We need to have a strategy on how we are going manage reviewing,
> removing out of date content, and moving valid content from the existing
> Wiki.  A lot of the existing content is out of date or irrelevant.  We
> need to be careful that we don't end up having two half baked Wikis for
> Geronimo.

I agree John. Allowing stale content to remain is worse than having no
content at all. What we really need is for someone to own the online
content and serve as a wrangler for it. And, no, I am not volunteering
;-) (I certainly see the need but I don't have the time).

> Maybe ApacheCon would be a good opportunity to get everyone together and
> review the content in the existing Wiki.  IMHO, if we don't have
> accurate documentation for the 1.0 release then we should reconsidering
> the release (we kind of had an excuse for milestone releases, 1.0 should
> be a step up in quality from milestones.. users will have expectations
> of quality).

Good point, let's plan on discussing this over the weekend at ApacheCon.

> The site shows we are using an Evaluation License.  We should have a
> full license if we are relying upon it.

Jason said he was working to get the open source license.

> Is there a way we can set the footer on every page to say that any
> content contributed to the Wiki is under the ASL 2.0 license, with a
> link to the license, or have a notice on the edit page?  Documentation
> contributions should not be any different to code contributions.

Agreed, I'm sure there's a way to set a footer containing the license.

Bruce
--
perl -e 'print unpack("u30","D0G)[EMAIL 
PROTECTED]&5R\"F)R=6-E+G-N>61Ehttp://www.castor.org/

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


Re: Confluence Setup

2005-12-04 Thread John Sisson

Jason Dillon wrote:


FYI, I imported the GERONIMO space from:

http://opensource2.atlassian.com/confluence/oss/display/GERONIMO/ 
Home


Are we allowed to run this in the zone?  It would be nice to get 
confirmation of this (how I don't know) as I don't think users will be 
happy if they contribute to it and then have the rug pulled from under 
their feet.


I suggest that we reorganize this content into another space(s).  I  
created a USERGUIDE10 and ADMINGUIDE10 space... not sure if we want  
to segregate the docs like that, but I think that we should be the  
documentation into a separate space from the main site space (similar  
to how Confluence docs are http://confluence.atlassian.com/display/ 
CONF20/Confluence+2.0+Home).


So right now there is:

MAIN - The main site space, this is kind of a facade over the rest of  
the spaces

DEV - Space for development/developers content
SANDBOX - Where people can freely play with wiki markup
INT - Internal space for common images, etc, not directly accessible  
by normal users


And these guys too:

GERONIMO - The imported space as mentioned above
USERGUIDE10 - Empty
ADMINGUIDE10 - Empty

I'm not sure that we need a separate user vs. admin guide right  
now... so perhaps we can just collect all of the documentation into a  
DOC10 or GUIDE10 space or something.


Any suggestions or recommendations?

We need to have a strategy on how we are going manage reviewing, 
removing out of date content, and moving valid content from the existing 
Wiki.  A lot of the existing content is out of date or irrelevant.  We 
need to be careful that we don't end up having two half baked Wikis for 
Geronimo. 

Maybe ApacheCon would be a good opportunity to get everyone together and 
review the content in the existing Wiki.  IMHO, if we don't have 
accurate documentation for the 1.0 release then we should reconsidering 
the release (we kind of had an excuse for milestone releases, 1.0 should 
be a step up in quality from milestones.. users will have expectations 
of quality).


The site shows we are using an Evaluation License.  We should have a 
full license if we are relying upon it.


Is there a way we can set the footer on every page to say that any 
content contributed to the Wiki is under the ASL 2.0 license, with a 
link to the license, or have a notice on the edit page?  Documentation 
contributions should not be any different to code contributions.


I was also thinking of adding a simple glossary and knowledge-base  
space and/or faq space, that would auto-generate listings for pages  
added and provide simple navigation (similar to http:// 
confluence.atlassian.com/display/DISC/Home).


I am not that familiar with Confluence, but it appears that the URL 
above hosts discussions.  Do we really want to encourage users to have 
discussions in places other than the mailing lists?  If we could import 
all of Geronimo's mail archives into its searchable mail interface... 
that sounds powerful as they say it is fully indexed and searchable with 
your other content.


http://www.atlassian.com/software/confluence/features/mail.jsp

IMHO we don't want users having to search in two different places to 
find information.


John



--jason


On Dec 3, 2005, at 8:03 PM, Bruce Snyder wrote:


On 12/3/05, Jason Dillon <[EMAIL PROTECTED]> wrote:


Okay, its up:

 http://geronimo.zones.apache.org










Re: Confluence Setup

2005-12-04 Thread Jason Dillon

FYI, I imported the GERONIMO space from:

http://opensource2.atlassian.com/confluence/oss/display/GERONIMO/ 
Home


I suggest that we reorganize this content into another space(s).  I  
created a USERGUIDE10 and ADMINGUIDE10 space... not sure if we want  
to segregate the docs like that, but I think that we should be the  
documentation into a separate space from the main site space (similar  
to how Confluence docs are http://confluence.atlassian.com/display/ 
CONF20/Confluence+2.0+Home).


So right now there is:

MAIN - The main site space, this is kind of a facade over the rest of  
the spaces

DEV - Space for development/developers content
SANDBOX - Where people can freely play with wiki markup
INT - Internal space for common images, etc, not directly accessible  
by normal users


And these guys too:

GERONIMO - The imported space as mentioned above
USERGUIDE10 - Empty
ADMINGUIDE10 - Empty

I'm not sure that we need a separate user vs. admin guide right  
now... so perhaps we can just collect all of the documentation into a  
DOC10 or GUIDE10 space or something.


Any suggestions or recommendations?

I was also thinking of adding a simple glossary and knowledge-base  
space and/or faq space, that would auto-generate listings for pages  
added and provide simple navigation (similar to http:// 
confluence.atlassian.com/display/DISC/Home).


--jason


On Dec 3, 2005, at 8:03 PM, Bruce Snyder wrote:


On 12/3/05, Jason Dillon <[EMAIL PROTECTED]> wrote:

Okay, its up:

 http://geronimo.zones.apache.org





Re: Confluence Setup

2005-12-03 Thread Jason Dillon
Um.. well... I'm still setting up what the Geronimo site 'could' be  
like w/Confluence on our zone.


:-\

--jason


On Dec 3, 2005, at 9:11 PM, Bruce Snyder wrote:


On 12/3/05, Jason Dillon <[EMAIL PROTECTED]> wrote:

Hrm...

Well... ASF Infra does not seem to "happy" about this.  I just asked
them if there was a smtp server I could use for notifications and
basically got jumped on... *whimper*


You can't say you weren't warned ;-).


I got smacked for using 100m for the install too... er, so I'm not
sure how long this instance will actually be up and running, as there
was some comments indicating they might just shutdown the zone.

I'm saddened to see that the level of politics is still the same
after several years.

Can someone point me to the discussions for/against using Confluence
on infrastructure@, I'm interested to see what has been said about it
before I ruin into any more hostility for helping out.


You'll need to subscribe to infra@ using your @apache.org address.
Once you're on that list, I can assist you in retrieving the threads
via ezmlm if you're interested.

Bruce
--
perl -e 'print unpack("u30","D0G)[EMAIL PROTECTED]&5R\"F)R=6-E+G-N>61EG;6%I;\"YC;VT*"

);'

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

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




Re: Confluence Setup

2005-12-03 Thread John Sisson
My understanding of the situation with the Infra folks is that it was 
acknowledged by Atlassian that Confluence can have some stability issues 
if Confluence were slashdotted and they will have to address that.  Once 
Atlassian have that fixed the potential problem it would be more likely 
that Infra will +1 a trial.


John

Jason Dillon wrote:


Hrm...

Well... ASF Infra does not seem to "happy" about this.  I just asked  
them if there was a smtp server I could use for notifications and  
basically got jumped on... *whimper*


I got smacked for using 100m for the install too... er, so I'm not  
sure how long this instance will actually be up and running, as there  
was some comments indicating they might just shutdown the zone.


I'm saddened to see that the level of politics is still the same  
after several years.


Can someone point me to the discussions for/against using Confluence  
on infrastructure@, I'm interested to see what has been said about it  
before I ruin into any more hostility for helping out.


:-(

Anyways, if you haven't seen it yet, take a peek at it now before it  
goes down:


   http://geronimo.zones.apache.org

I think its got a lot of promise for Geronimo project documentation.

--jason


On Dec 3, 2005, at 8:03 PM, Bruce Snyder wrote:


On 12/3/05, Jason Dillon <[EMAIL PROTECTED]> wrote:


Okay, its up:

 http://geronimo.zones.apache.org

I did some initial setup, but there isn't really any content on here
just yet.

Right now its using the embedded HSQL db that comes with Confluence
standalone.  I will switch this to an external once I can resolve how
to get one installed in our zone.

I installed several plugins, may install more when I have confirmed
they work with Confluence 2.0.

You need to create an account to modify content.  Currently the main
page is locked down to administrators only.

The main space, and site home page is the MAIN space.  I imagine we
will create a space for the user guide and admin guides (USERGUIDE10
and ADMINGUIDE10 respectively)... er something like that.

The home page has an example of using tabs, as well as the cool
lozenge macro (see the documentation tab).

There is also an Internal space which is only viewable/editable by
admins, but contains common images, etc as well as the welcome page
content for the dashboard and homepage.

I still need to request an oss license, so right now were have an
eval license.

Notifications are currently offline until I can figure out the right
smtp server to use, but hopefully I will get that online soon.

More to come, comments and suggestions are welcomed.



Thanks, Jason.

At one point Aaron said that he had a MoinMoin2Confluence migration
script. Aaron, do you still have this?

Bruce
--
perl -e 'print unpack("u30","D0G)[EMAIL PROTECTED]&5R\"F)R=6-E+G-N>61EG;6%I;\"YC;VT*"

);'

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

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








Re: Confluence Setup

2005-12-03 Thread Davanum Srinivas
FYI, there are over 200 emails debating about pros and cons on the
infra@ mailing list. Situation is not black and white as is being
painted :(

-- dims

On 12/4/05, Bruce Snyder <[EMAIL PROTECTED]> wrote:
> On 12/3/05, Jason Dillon <[EMAIL PROTECTED]> wrote:
> > Hrm... I'd love to subscribe to infra@ except my @apache.org email is
> > going into the void... nothing sent to [EMAIL PROTECTED] is ever
> > delivered to the address in my .forward :-(
>
> Yeah, mine does that too, so I use an ezmlm trick to subscribe using a
> different email address. Below is :
>
> [EMAIL PROTECTED]
>
> Replace the list name with any list name and my email address with the
> one you'd like to use. Notice the equals sign in there - that's
> correct and it's the key to the trick.
>
> > I'm reading some links to gmane archives on the subject now, and so
> > far I don't see any concrete reasons not to use Confluence.
>
> You're not going to find the real discussions on a public archive.
>
> Bruce
> --
> perl -e 'print unpack("u30","D0G)[EMAIL 
> PROTECTED]&5R\"F)R=6-E+G-N>61E );'
>
> The Castor Project
> http://www.castor.org/
>
> Apache Geronimo
> http://geronimo.apache.org/
>


--
Davanum Srinivas : http://wso2.com/blogs/


Re: Confluence Setup

2005-12-03 Thread Bruce Snyder
On 12/3/05, Jason Dillon <[EMAIL PROTECTED]> wrote:
> Hrm... I'd love to subscribe to infra@ except my @apache.org email is
> going into the void... nothing sent to [EMAIL PROTECTED] is ever
> delivered to the address in my .forward :-(

Yeah, mine does that too, so I use an ezmlm trick to subscribe using a
different email address. Below is :

[EMAIL PROTECTED]

Replace the list name with any list name and my email address with the
one you'd like to use. Notice the equals sign in there - that's
correct and it's the key to the trick.

> I'm reading some links to gmane archives on the subject now, and so
> far I don't see any concrete reasons not to use Confluence.

You're not going to find the real discussions on a public archive.

Bruce
--
perl -e 'print unpack("u30","D0G)[EMAIL 
PROTECTED]&5R\"F)R=6-E+G-N>61Ehttp://www.castor.org/

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


Re: Confluence Setup

2005-12-03 Thread Jason Dillon
Hrm... I'd love to subscribe to infra@ except my @apache.org email is  
going into the void... nothing sent to [EMAIL PROTECTED] is ever  
delivered to the address in my .forward :-(


So until I get that resolved I can't really use that address.

I'm reading some links to gmane archives on the subject now, and so  
far I don't see any concrete reasons not to use Confluence.


--jason


On Dec 3, 2005, at 9:11 PM, Bruce Snyder wrote:


On 12/3/05, Jason Dillon <[EMAIL PROTECTED]> wrote:

Hrm...

Well... ASF Infra does not seem to "happy" about this.  I just asked
them if there was a smtp server I could use for notifications and
basically got jumped on... *whimper*


You can't say you weren't warned ;-).


I got smacked for using 100m for the install too... er, so I'm not
sure how long this instance will actually be up and running, as there
was some comments indicating they might just shutdown the zone.

I'm saddened to see that the level of politics is still the same
after several years.

Can someone point me to the discussions for/against using Confluence
on infrastructure@, I'm interested to see what has been said about it
before I ruin into any more hostility for helping out.


You'll need to subscribe to infra@ using your @apache.org address.
Once you're on that list, I can assist you in retrieving the threads
via ezmlm if you're interested.

Bruce
--
perl -e 'print unpack("u30","D0G)[EMAIL PROTECTED]&5R\"F)R=6-E+G-N>61EG;6%I;\"YC;VT*"

);'

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

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




Re: Confluence Setup

2005-12-03 Thread Bruce Snyder
On 12/3/05, Jason Dillon <[EMAIL PROTECTED]> wrote:
> Hrm...
>
> Well... ASF Infra does not seem to "happy" about this.  I just asked
> them if there was a smtp server I could use for notifications and
> basically got jumped on... *whimper*

You can't say you weren't warned ;-).

> I got smacked for using 100m for the install too... er, so I'm not
> sure how long this instance will actually be up and running, as there
> was some comments indicating they might just shutdown the zone.
>
> I'm saddened to see that the level of politics is still the same
> after several years.
>
> Can someone point me to the discussions for/against using Confluence
> on infrastructure@, I'm interested to see what has been said about it
> before I ruin into any more hostility for helping out.

You'll need to subscribe to infra@ using your @apache.org address.
Once you're on that list, I can assist you in retrieving the threads
via ezmlm if you're interested.

Bruce
--
perl -e 'print unpack("u30","D0G)[EMAIL 
PROTECTED]&5R\"F)R=6-E+G-N>61Ehttp://www.castor.org/

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


Re: Confluence Setup

2005-12-03 Thread Jason Dillon

Hey, thanks for the links.  I will take a peek.

--jason


On Dec 3, 2005, at 9:04 PM, Davanum Srinivas wrote:


Jason,

I made it very clear that infra@ has not blessed a confluence install:
http://article.gmane.org/gmane.comp.java.geronimo.devel/17450/

And asking folks to engage on the infra@ list:
http://thread.gmane.org/gmane.comp.java.geronimo.devel/17370
http://article.gmane.org/gmane.comp.java.geronimo.devel/17436

See this message from geir as well:
http://article.gmane.org/gmane.comp.java.geronimo.devel/17522

So what's the issue here? We should have got an explicit OK before
going ahead with an install...no?

thanks,
dims

On 12/3/05, Jason Dillon <[EMAIL PROTECTED]> wrote:

Hrm...

Well... ASF Infra does not seem to "happy" about this.  I just asked
them if there was a smtp server I could use for notifications and
basically got jumped on... *whimper*

I got smacked for using 100m for the install too... er, so I'm not
sure how long this instance will actually be up and running, as there
was some comments indicating they might just shutdown the zone.

I'm saddened to see that the level of politics is still the same
after several years.

Can someone point me to the discussions for/against using Confluence
on infrastructure@, I'm interested to see what has been said about it
before I ruin into any more hostility for helping out.

:-(

Anyways, if you haven't seen it yet, take a peek at it now before it
goes down:

http://geronimo.zones.apache.org

I think its got a lot of promise for Geronimo project documentation.

--jason


On Dec 3, 2005, at 8:03 PM, Bruce Snyder wrote:


On 12/3/05, Jason Dillon <[EMAIL PROTECTED]> wrote:

Okay, its up:

 http://geronimo.zones.apache.org

I did some initial setup, but there isn't really any content on  
here

just yet.

Right now its using the embedded HSQL db that comes with Confluence
standalone.  I will switch this to an external once I can  
resolve how

to get one installed in our zone.

I installed several plugins, may install more when I have confirmed
they work with Confluence 2.0.

You need to create an account to modify content.  Currently the  
main

page is locked down to administrators only.

The main space, and site home page is the MAIN space.  I imagine we
will create a space for the user guide and admin guides  
(USERGUIDE10

and ADMINGUIDE10 respectively)... er something like that.

The home page has an example of using tabs, as well as the cool
lozenge macro (see the documentation tab).

There is also an Internal space which is only viewable/editable by
admins, but contains common images, etc as well as the welcome page
content for the dashboard and homepage.

I still need to request an oss license, so right now were have an
eval license.

Notifications are currently offline until I can figure out the  
right

smtp server to use, but hopefully I will get that online soon.

More to come, comments and suggestions are welcomed.


Thanks, Jason.

At one point Aaron said that he had a MoinMoin2Confluence migration
script. Aaron, do you still have this?

Bruce
--
perl -e 'print unpack("u30","D0G)[EMAIL PROTECTED]&5R\"F)R=6-E+G-N>61Ehttp://www.castor.org/

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






--
Davanum Srinivas : http://wso2.com/blogs/




Re: Confluence Setup

2005-12-03 Thread Davanum Srinivas
Jason,

I made it very clear that infra@ has not blessed a confluence install:
http://article.gmane.org/gmane.comp.java.geronimo.devel/17450/

And asking folks to engage on the infra@ list:
http://thread.gmane.org/gmane.comp.java.geronimo.devel/17370
http://article.gmane.org/gmane.comp.java.geronimo.devel/17436

See this message from geir as well:
http://article.gmane.org/gmane.comp.java.geronimo.devel/17522

So what's the issue here? We should have got an explicit OK before
going ahead with an install...no?

thanks,
dims

On 12/3/05, Jason Dillon <[EMAIL PROTECTED]> wrote:
> Hrm...
>
> Well... ASF Infra does not seem to "happy" about this.  I just asked
> them if there was a smtp server I could use for notifications and
> basically got jumped on... *whimper*
>
> I got smacked for using 100m for the install too... er, so I'm not
> sure how long this instance will actually be up and running, as there
> was some comments indicating they might just shutdown the zone.
>
> I'm saddened to see that the level of politics is still the same
> after several years.
>
> Can someone point me to the discussions for/against using Confluence
> on infrastructure@, I'm interested to see what has been said about it
> before I ruin into any more hostility for helping out.
>
> :-(
>
> Anyways, if you haven't seen it yet, take a peek at it now before it
> goes down:
>
> http://geronimo.zones.apache.org
>
> I think its got a lot of promise for Geronimo project documentation.
>
> --jason
>
>
> On Dec 3, 2005, at 8:03 PM, Bruce Snyder wrote:
>
> > On 12/3/05, Jason Dillon <[EMAIL PROTECTED]> wrote:
> >> Okay, its up:
> >>
> >>  http://geronimo.zones.apache.org
> >>
> >> I did some initial setup, but there isn't really any content on here
> >> just yet.
> >>
> >> Right now its using the embedded HSQL db that comes with Confluence
> >> standalone.  I will switch this to an external once I can resolve how
> >> to get one installed in our zone.
> >>
> >> I installed several plugins, may install more when I have confirmed
> >> they work with Confluence 2.0.
> >>
> >> You need to create an account to modify content.  Currently the main
> >> page is locked down to administrators only.
> >>
> >> The main space, and site home page is the MAIN space.  I imagine we
> >> will create a space for the user guide and admin guides (USERGUIDE10
> >> and ADMINGUIDE10 respectively)... er something like that.
> >>
> >> The home page has an example of using tabs, as well as the cool
> >> lozenge macro (see the documentation tab).
> >>
> >> There is also an Internal space which is only viewable/editable by
> >> admins, but contains common images, etc as well as the welcome page
> >> content for the dashboard and homepage.
> >>
> >> I still need to request an oss license, so right now were have an
> >> eval license.
> >>
> >> Notifications are currently offline until I can figure out the right
> >> smtp server to use, but hopefully I will get that online soon.
> >>
> >> More to come, comments and suggestions are welcomed.
> >
> > Thanks, Jason.
> >
> > At one point Aaron said that he had a MoinMoin2Confluence migration
> > script. Aaron, do you still have this?
> >
> > Bruce
> > --
> > perl -e 'print unpack("u30","D0G)[EMAIL PROTECTED]&5R\"F)R=6-E+G-N>61E > G;6%I;\"YC;VT*"
> > );'
> >
> > The Castor Project
> > http://www.castor.org/
> >
> > Apache Geronimo
> > http://geronimo.apache.org/
>
>


--
Davanum Srinivas : http://wso2.com/blogs/


Re: Confluence Setup

2005-12-03 Thread Jason Dillon

Hrm...

Well... ASF Infra does not seem to "happy" about this.  I just asked  
them if there was a smtp server I could use for notifications and  
basically got jumped on... *whimper*


I got smacked for using 100m for the install too... er, so I'm not  
sure how long this instance will actually be up and running, as there  
was some comments indicating they might just shutdown the zone.


I'm saddened to see that the level of politics is still the same  
after several years.


Can someone point me to the discussions for/against using Confluence  
on infrastructure@, I'm interested to see what has been said about it  
before I ruin into any more hostility for helping out.


:-(

Anyways, if you haven't seen it yet, take a peek at it now before it  
goes down:


   http://geronimo.zones.apache.org

I think its got a lot of promise for Geronimo project documentation.

--jason


On Dec 3, 2005, at 8:03 PM, Bruce Snyder wrote:


On 12/3/05, Jason Dillon <[EMAIL PROTECTED]> wrote:

Okay, its up:

 http://geronimo.zones.apache.org

I did some initial setup, but there isn't really any content on here
just yet.

Right now its using the embedded HSQL db that comes with Confluence
standalone.  I will switch this to an external once I can resolve how
to get one installed in our zone.

I installed several plugins, may install more when I have confirmed
they work with Confluence 2.0.

You need to create an account to modify content.  Currently the main
page is locked down to administrators only.

The main space, and site home page is the MAIN space.  I imagine we
will create a space for the user guide and admin guides (USERGUIDE10
and ADMINGUIDE10 respectively)... er something like that.

The home page has an example of using tabs, as well as the cool
lozenge macro (see the documentation tab).

There is also an Internal space which is only viewable/editable by
admins, but contains common images, etc as well as the welcome page
content for the dashboard and homepage.

I still need to request an oss license, so right now were have an
eval license.

Notifications are currently offline until I can figure out the right
smtp server to use, but hopefully I will get that online soon.

More to come, comments and suggestions are welcomed.


Thanks, Jason.

At one point Aaron said that he had a MoinMoin2Confluence migration
script. Aaron, do you still have this?

Bruce
--
perl -e 'print unpack("u30","D0G)[EMAIL PROTECTED]&5R\"F)R=6-E+G-N>61EG;6%I;\"YC;VT*"

);'

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

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




Re: Confluence Setup

2005-12-03 Thread Bruce Snyder
On 12/3/05, Jason Dillon <[EMAIL PROTECTED]> wrote:
> Okay, its up:
>
>  http://geronimo.zones.apache.org
>
> I did some initial setup, but there isn't really any content on here
> just yet.
>
> Right now its using the embedded HSQL db that comes with Confluence
> standalone.  I will switch this to an external once I can resolve how
> to get one installed in our zone.
>
> I installed several plugins, may install more when I have confirmed
> they work with Confluence 2.0.
>
> You need to create an account to modify content.  Currently the main
> page is locked down to administrators only.
>
> The main space, and site home page is the MAIN space.  I imagine we
> will create a space for the user guide and admin guides (USERGUIDE10
> and ADMINGUIDE10 respectively)... er something like that.
>
> The home page has an example of using tabs, as well as the cool
> lozenge macro (see the documentation tab).
>
> There is also an Internal space which is only viewable/editable by
> admins, but contains common images, etc as well as the welcome page
> content for the dashboard and homepage.
>
> I still need to request an oss license, so right now were have an
> eval license.
>
> Notifications are currently offline until I can figure out the right
> smtp server to use, but hopefully I will get that online soon.
>
> More to come, comments and suggestions are welcomed.

Thanks, Jason.

At one point Aaron said that he had a MoinMoin2Confluence migration
script. Aaron, do you still have this?

Bruce
--
perl -e 'print unpack("u30","D0G)[EMAIL 
PROTECTED]&5R\"F)R=6-E+G-N>61Ehttp://www.castor.org/

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


Re: Confluence Setup

2005-12-03 Thread Jason Dillon

Okay, its up:

http://geronimo.zones.apache.org

I did some initial setup, but there isn't really any content on here  
just yet.


Right now its using the embedded HSQL db that comes with Confluence  
standalone.  I will switch this to an external once I can resolve how  
to get one installed in our zone.


I installed several plugins, may install more when I have confirmed  
they work with Confluence 2.0.


You need to create an account to modify content.  Currently the main  
page is locked down to administrators only.


The main space, and site home page is the MAIN space.  I imagine we  
will create a space for the user guide and admin guides (USERGUIDE10  
and ADMINGUIDE10 respectively)... er something like that.


The home page has an example of using tabs, as well as the cool  
lozenge macro (see the documentation tab).


There is also an Internal space which is only viewable/editable by  
admins, but contains common images, etc as well as the welcome page  
content for the dashboard and homepage.


I still need to request an oss license, so right now were have an  
eval license.


Notifications are currently offline until I can figure out the right  
smtp server to use, but hopefully I will get that online soon.


More to come, comments and suggestions are welcomed.

Cheers,

--jason


On Dec 3, 2005, at 2:32 PM, David Blevins wrote:


On Dec 3, 2005, at 2:14 PM, Jason Dillon wrote:

Is there a MySQL database available for Geronimo use?  We probably  
want to use an external RDMBS to back the Confluence setup.




I think it's pretty much vanilla zone with nothing in it really.   
We got it a month or so ago and haven't done anything with it yet.   
So you're the first!


I can start with the standalone and we can migrate to an external  
RDBMS later if there isn't one available right now.




I'm fine with whatever RDBMS you are willing to maintain :)

Also, unless someone has a better suggestion, I'm going to put all  
of this under /opt/confluence.




Works for me.


--jason

PS. Zones looks cool... too bad its not Linux though :-(



Yea, that throws me too.

-David



On Dec 2, 2005, at 6:48 PM, David Blevins wrote:


On Dec 2, 2005, at 5:15 PM, Jason Dillon wrote:


I'd love to... but what the heck is a zone?



Awesome!  Here is the zone info i am aware of:  http:// 
www.apache.org/dev/solaris-zones.html


I'll set you up an account.

-David








Re: Confluence Setup (was: Re: zones update)

2005-12-03 Thread Jason Dillon

Anyone know what smtp server is available in our zone that will relay?

Need one for Confluence email notifications.

--jason


On Dec 3, 2005, at 2:32 PM, David Blevins wrote:


On Dec 3, 2005, at 2:14 PM, Jason Dillon wrote:

Is there a MySQL database available for Geronimo use?  We probably  
want to use an external RDMBS to back the Confluence setup.




I think it's pretty much vanilla zone with nothing in it really.   
We got it a month or so ago and haven't done anything with it yet.   
So you're the first!


I can start with the standalone and we can migrate to an external  
RDBMS later if there isn't one available right now.




I'm fine with whatever RDBMS you are willing to maintain :)

Also, unless someone has a better suggestion, I'm going to put all  
of this under /opt/confluence.




Works for me.


--jason

PS. Zones looks cool... too bad its not Linux though :-(



Yea, that throws me too.

-David



On Dec 2, 2005, at 6:48 PM, David Blevins wrote:


On Dec 2, 2005, at 5:15 PM, Jason Dillon wrote:


I'd love to... but what the heck is a zone?



Awesome!  Here is the zone info i am aware of:  http:// 
www.apache.org/dev/solaris-zones.html


I'll set you up an account.

-David








Re: Confluence Setup (was: Re: zones update)

2005-12-03 Thread Jason Dillon
FYI, MoinMoin ain't got nuthin on the latest plugins for Confluence,  
like the Composition plugin:


   http://www.randombits.org/display/CONF/Home

If you haven't seen these, you really gotta check them out.  The tabs  
and clocking macros turn any ordinary flat wiki page into a dynamic  
documentation application.


Um, anyways... Its been a long time since I was on the infra list...  
but I tend to recall they listen to reason, and I believe that the  
move to Confluence is more than reasonable.  So perhaps they just  
need a bit more convincing and a hearty nudge.


--jason


On Dec 3, 2005, at 2:25 PM, Bruce Snyder wrote:


On 12/3/05, Jason Dillon <[EMAIL PROTECTED]> wrote:

Is there a MySQL database available for Geronimo use?  We probably
want to use an external RDMBS to back the Confluence setup.

I can start with the standalone and we can migrate to an external
RDBMS later if there isn't one available right now.

Also, unless someone has a better suggestion, I'm going to put all of
this under /opt/confluence.


There has been some raging debate over weather we should use
Confluence over on the infrastruture list. The powers that be say
we've already got a wiki and we should just use it. The alternative
was that we run our own Confluence instance from the Solaris zone -
that went over like a lead balloon with infrastructure.

Bruce
--
perl -e 'print unpack("u30","D0G)[EMAIL PROTECTED]&5R\"F)R=6-E+G-N>61EG;6%I;\"YC;VT*"

);'

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

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




Re: Confluence Setup (was: Re: zones update)

2005-12-03 Thread Jason Dillon
At the time which I recommended to the Infra list to switch from  
UseMod to MoinMoin, I did not think that Confluence was going to grow  
up as fast as it did... or I would have been more inclined to  
recommend Confluence.


But, things change...

And I believe that Confluence is really a much more powerful system  
than MoinMoin is and will be for quite some time.


The added niceness of the rich integration with JIRA makes Confluence  
an ideal choice for managing rich release notes.


And now with Confluence 2.x there is a RTE so even people who aren't  
wiki savvy can easily add to the content.


Oh, and not to mention that it has built in support for "farming"...  
aka spaces, and a much richer permission system.


I could go on...

Right now, I think that Geronimo would really benefit from Confluence  
to produce and manage user documentation.


I think that Infra might eventually want to move to it for  
wiki.apache.org too, but right now I don't think we should push for  
that.  We can lead by example.  And when/if they want to switch I can  
help them migrate, it should be much easier than the UseMod to  
MoinMoin move that was done... um 2 years ago... I forget.


--jason


On Dec 3, 2005, at 2:25 PM, Bruce Snyder wrote:


On 12/3/05, Jason Dillon <[EMAIL PROTECTED]> wrote:

Is there a MySQL database available for Geronimo use?  We probably
want to use an external RDMBS to back the Confluence setup.

I can start with the standalone and we can migrate to an external
RDBMS later if there isn't one available right now.

Also, unless someone has a better suggestion, I'm going to put all of
this under /opt/confluence.


There has been some raging debate over weather we should use
Confluence over on the infrastruture list. The powers that be say
we've already got a wiki and we should just use it. The alternative
was that we run our own Confluence instance from the Solaris zone -
that went over like a lead balloon with infrastructure.

Bruce
--
perl -e 'print unpack("u30","D0G)[EMAIL PROTECTED]&5R\"F)R=6-E+G-N>61EG;6%I;\"YC;VT*"

);'

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

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




Re: Confluence Setup (was: Re: zones update)

2005-12-03 Thread David Blevins

On Dec 3, 2005, at 2:14 PM, Jason Dillon wrote:

Is there a MySQL database available for Geronimo use?  We probably  
want to use an external RDMBS to back the Confluence setup.




I think it's pretty much vanilla zone with nothing in it really.  We  
got it a month or so ago and haven't done anything with it yet.  So  
you're the first!


I can start with the standalone and we can migrate to an external  
RDBMS later if there isn't one available right now.




I'm fine with whatever RDBMS you are willing to maintain :)

Also, unless someone has a better suggestion, I'm going to put all  
of this under /opt/confluence.




Works for me.


--jason

PS. Zones looks cool... too bad its not Linux though :-(



Yea, that throws me too.

-David



On Dec 2, 2005, at 6:48 PM, David Blevins wrote:


On Dec 2, 2005, at 5:15 PM, Jason Dillon wrote:


I'd love to... but what the heck is a zone?



Awesome!  Here is the zone info i am aware of:  http:// 
www.apache.org/dev/solaris-zones.html


I'll set you up an account.

-David






Re: Confluence Setup (was: Re: zones update)

2005-12-03 Thread Bruce Snyder
On 12/3/05, Jason Dillon <[EMAIL PROTECTED]> wrote:
> Is there a MySQL database available for Geronimo use?  We probably
> want to use an external RDMBS to back the Confluence setup.
>
> I can start with the standalone and we can migrate to an external
> RDBMS later if there isn't one available right now.
>
> Also, unless someone has a better suggestion, I'm going to put all of
> this under /opt/confluence.

There has been some raging debate over weather we should use
Confluence over on the infrastruture list. The powers that be say
we've already got a wiki and we should just use it. The alternative
was that we run our own Confluence instance from the Solaris zone -
that went over like a lead balloon with infrastructure.

Bruce
--
perl -e 'print unpack("u30","D0G)[EMAIL 
PROTECTED]&5R\"F)R=6-E+G-N>61Ehttp://www.castor.org/

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