You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@incubator.apache.org by J Aaron Farr <fa...@apache.org> on 2004/10/19 15:26:22 UTC
Mentor and Project Guide (WAS: RE: [OT] How to prevent...)
> -----Original Message-----
> From: Ted Husted [mailto:husted@apache.org]
> Sent: Tuesday, October 19, 2004 4:29 AM
> To: general@incubator.apache.org
> Subject: Re: [OT] How to prevent abusing Apache priviliges
>
> On Mon, 18 Oct 2004 19:28:56 -0400, J Aaron Farr wrote:
> > Where are you working on this? I'd love to help.
> >
> > jaaron
>
> We should probably work on it in the Incubator repository. Perhaps as a
> standalone whiteboard document first, and then as the Projects page, when
> it's ready for prime time.
>
> If you want to start the ball rolling by reducing the outline to XML, that
> would be great. So far, that's all I have down.
Sounds good. Couple of questions and thoughts:
How big were you thinking of making this? Your outline suggests several
pages at least. Or were you thinking of just one page?
I suppose this is going to be authored in Forrest or perhaps Docbook.
I had been thinking of putting together additional documents for those
interested in going through the incubator [1]. We regularly get questions
like: "I'm the lead for project ABC which would be a great addition to
Apache. How do we join?" Some points of your outline touched on this,
but I may still be interested in writing a very simple, user friendly
guide to contributing to the ASF. I'm never satisfied with current
documentation. :)
On a final note, I don't believe I have any SVN commit rights to anything
in the incubator. I can work up some Forrest or Docbook XML stubs based
on the outline and if everyone like them, then perhaps I can get access to
putting them somewhere. Or I could start in the wiki, but in that case,
I'd start on content rather than the XML structure.
jaaron
[1] http://marc.theaimsgroup.com/?l=incubator-general&m=109181155826131&w=2
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: Mentor and Project Guide (WAS: RE: [OT] How to prevent...)
Posted by Nicola Ken Barozzi <ni...@apache.org>.
David Crossley wrote:
> Ted Husted wrote:
>
>>Jaaron,
>>
>>Either place is fine with me. Though, now that you mention it,
>>the wiki might be a more collaborative place to start.
>
> I presume that these new documents are going to
> be at the Incubator website under control of SVN.
> When i hear people say "start at the wiki" i get
> worried that the docs stay there and we get a mess
> of duplication.
Then, I say it again :-) , let's use html and give subversion access
without too much worry to Apache committers. In this way they can add
docs without even having to generate the site and others can browser the
docs in process via viewcvs.
--
Nicola Ken Barozzi nicolaken@apache.org
- verba volant, scripta manent -
(discussions get forgotten, just code remains)
---------------------------------------------------------------------
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: Mentor and Project Guide (WAS: RE: [OT] How to prevent...)
Posted by David Crossley <cr...@apache.org>.
Ted Husted wrote:
> Jaaron,
>
> Either place is fine with me. Though, now that you mention it,
> the wiki might be a more collaborative place to start.
I presume that these new documents are going to
be at the Incubator website under control of SVN.
When i hear people say "start at the wiki" i get
worried that the docs stay there and we get a mess
of duplication.
> Here's another old link with some material we could incorporate:
>
> * http://jakarta.apache.org/site/guides.html
>
> Though it now overlaps with material available elsewhere.
This is the big worry - there is so much overlapping
and often conflicting material scattered over many websites.
--
David Crossley
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: Mentor and Project Guide (WAS: RE: [OT] How to prevent...)
Posted by Ted Husted <hu...@apache.org>.
Jaaron,
Either place is fine with me. Though, now that you mention it, the wiki might be a more collaborative place to start.
Here's another old link with some material we could incorporate:
* http://jakarta.apache.org/site/guides.html
Though it now overlaps with material available elsewhere.
-Ted.
On Tue, 19 Oct 2004 17:18:57 +0200, Nicola Ken Barozzi wrote:
>
> J Aaron Farr wrote:
> ..
>> I suppose this is going to be authored in Forrest or perhaps
>> Docbook.
>>
> Do it in Forrest so it goes in the Incubator Docs; you can do it
> simply in html... just use the .ihtml extension.
>
> ..
>> On a final note, I don't believe I have any SVN commit rights to
>> anything in the incubator.
>>
>
> If you want to contribute, I don't think that there is nothing
> preventing you from asking commit rights.
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: Mentor and Project Guide (WAS: RE: [OT] How to prevent...)
Posted by Nicola Ken Barozzi <ni...@apache.org>.
J Aaron Farr wrote:
...
> I suppose this is going to be authored in Forrest or perhaps Docbook.
Do it in Forrest so it goes in the Incubator Docs; you can do it simply
in html... just use the .ihtml extension.
...
> On a final note, I don't believe I have any SVN commit rights to anything
> in the incubator.
If you want to contribute, I don't think that there is nothing
preventing you from asking commit rights.
--
Nicola Ken Barozzi nicolaken@apache.org
- verba volant, scripta manent -
(discussions get forgotten, just code remains)
---------------------------------------------------------------------
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: Mentor and Project Guide (WAS: RE: [OT] How to prevent...)
Posted by Ted Husted <hu...@apache.org>.
On Tue, 19 Oct 2004 09:26:22 -0400 (EDT), J Aaron Farr wrote:
> How big were you thinking of making this? Your outline suggests
> several pages at least. Or were you thinking of just one page?
It should be as short as we make make it, but no shorter :)
> I had been thinking of putting together additional documents for
> those interested in going through the incubator [1]. We regularly
> get questions like: "I'm the lead for project ABC which would be a
> great addition to Apache. How do we join?" Some points of your
> outline touched on this, but I may still be interested in writing a
> very simple, user friendly guide to contributing to the ASF. I'm
> never satisfied with current documentation. :)
Jakarta has some useful guidelines for the "do we qualify" question
* http://jakarta.apache.org/site/newproject.html
which people have used as the background for the emerging standard Incubator proposal format.
> On a final note, I don't believe I have any SVN commit rights to
> anything in the incubator. I can work up some Forrest or Docbook
> XML stubs based on the outline and if everyone like them, then
> perhaps I can get access to putting them somewhere. Or I could
> start in the wiki, but in that case, I'd start on content rather
> than the XML structure.
The wiki sounds like a fine place to get started.
-Ted.
On Tue, 19 Oct 2004 09:26:22 -0400 (EDT), J Aaron Farr wrote:
> Sounds good. Couple of questions and thoughts:
>
> How big were you thinking of making this? Your outline suggests
> several pages at least. Or were you thinking of just one page?
>
> I suppose this is going to be authored in Forrest or perhaps
> Docbook.
>
> I had been thinking of putting together additional documents for
> those interested in going through the incubator [1]. We regularly
> get questions like: "I'm the lead for project ABC which would be a
> great addition to Apache. How do we join?" Some points of your
> outline touched on this, but I may still be interested in writing a
> very simple, user friendly guide to contributing to the ASF. I'm
> never satisfied with current documentation. :)
>
> On a final note, I don't believe I have any SVN commit rights to
> anything in the incubator. I can work up some Forrest or Docbook
> XML stubs based on the outline and if everyone like them, then
> perhaps I can get access to putting them somewhere. Or I could
> start in the wiki, but in that case, I'd start on content rather
> than the XML structure.
>
> jaaron
>
> [1] http://marc.theaimsgroup.com/?l=incubator-
> general&m=109181155826131&w=2
>
> --------------------------------------------------------------------
> - To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org