You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@incubator.apache.org by Joe Schaefer <jo...@yahoo.com> on 2012/12/20 06:33:33 UTC
How to use an apache webpage
All webpages we host are works in progress subject to change when better consensus emerges. Please do not affix any labels to the pages describing them as drafts as that only serves to discourage others from working on them. Normative policy documents are few and far between and you will recognize them by their self-descriptions as such.
Every interested party is welcome to collaborate with us to produce more informative and accurate webpages through the CMS. Please help out where you can. Our documentation becomes increasingly authoritative as more and more people refer to it in positive ways; ie the best documents wear well over time.
HTH
Sent from my iPhone
On Dec 20, 2012, at 12:07 AM, Joe Schaefer <jo...@yahoo.com> wrote:
> Shane actually wrote that page but I still hate the exclusionary draft label he picked up from rbd.
>
> Sent from my iPhone
>
> On Dec 19, 2012, at 11:52 PM, Joe Schaefer <jo...@yahoo.com> wrote:
>
>> That's the whole problem with Robert's labels, they scare people away from working on the document while simultaneously pretend that there is some supercommittee who will determine when one of his drafts is no longer a draft.
>>
>> Sent from my iPhone
>>
>> On Dec 19, 2012, at 11:47 PM, Christian Grobmeier <gr...@gmail.com> wrote:
>>
>>> On Thu, Dec 20, 2012 at 5:44 AM, Joe Schaefer <jo...@yahoo.com> wrote:
>>>> That's just RBD's signature boilerplate for a document he likely started. Feel free to remove it if you think it detracts from the document.
>>>>
>>>
>>> I leave the labeling of a document to the people who worked on it
>>>
>>>
>>>> Sent from my iPhone
>>>>
>>>> On Dec 19, 2012, at 11:40 PM, Christian Grobmeier <gr...@gmail.com> wrote:
>>>>
>>>>> On Wed, Dec 19, 2012 at 11:43 PM, Daniel Shahaf <d....@daniel.shahaf.name> wrote:
>>>>>> Ross Gardler wrote on Wed, Dec 19, 2012 at 22:13:17 +0000:
>>>>>>> Christian, you can review any podling I'm a mentor on, including AOO, to
>>>>>>> see discussion of both models. I'm sure many other projects have discussed
>>>>>>> this too.
>>>>>>>
>>>>>>> The page you refer to is correct, there are two separate roles as
>>>>>>> recognised by the foundation.
>>>>>>>
>>>>>>> You do have a point that things can be documented more clearly, they always
>>>>>>> can be, but I don't think the how it works page is at fault. That page
>>>>>>> doesn't describe how someone gets those roles, it merely defines the roles
>>>>>>> the foundation recognises.
>>>>>>
>>>>>> http://www.apache.org/foundation/governance/pmcs#merit describes both
>>>>>> modes of operation.
>>>>>
>>>>> Didn't know about that document, but its good.
>>>>>
>>>>> Unfortunately: "This document is a DRAFT and should not be considered
>>>>> as a normative or detailed explanation at the current time."
>>>>>
>>>>> ---------------------------------------------------------------------
>>>>> 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
>>>>
>>>
>>>
>>>
>>> --
>>> http://www.grobmeier.de
>>> https://www.timeandbill.de
>>>
>>> ---------------------------------------------------------------------
>>> 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
>>
>
> ---------------------------------------------------------------------
> 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
Re: How to use an apache webpage
Posted by Benson Margulies <bi...@gmail.com>.
On Thu, Dec 20, 2012 at 11:15 PM, Christian Grobmeier
<gr...@gmail.com> wrote:
> On Fri, Dec 21, 2012 at 1:19 AM, Nick Burch <ap...@gagravarr.org> wrote:
>> On Thu, 20 Dec 2012, Shane Curcuru wrote:
>>>
>>> I put the DRAFT on because I originally wrote these for my personal
>>> Community Over Code site, and I wanted to ensure the style was appropriate
>>> for a path under a.o/foundation, which makes it official.
>>
>>
>> I wonder if a label like "work in progress" might be better suited, if we
>> want to indicate in future that something is incomplete but input is
>> welcomed?
If I follow this thread, the point is that (a) we have no process for
formally approving the docs in question, so (b) they always remain
W-I-P or DRAFT, so (c) no one knows whether to believe them.
The proposal here, to which I am +1, is that all of the docs are
subject to patches and vetos. So we need no such marking, but rather
the members of the responsible PMC need to act on their responsibility
and talk/act if they see something so wrong that someone should *not*
believe it. Until then, we trust the committers of these docs to
commit things that people should believe.
If someone wants to propose a small-print footer that copies this
policy, which is already on the incubator 'how to update the website
page', someone should, well, commit it.
>
> Only if you tell people who is working on it (to submit patches) and
> if the content of the document can be used (or not).
>
> Christian
>
>>
>> Nick
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
>> For additional commands, e-mail: general-help@incubator.apache.org
>>
>
>
>
> --
> http://www.grobmeier.de
> https://www.timeandbill.de
>
> ---------------------------------------------------------------------
> 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
Re: How to use an apache webpage
Posted by Christian Grobmeier <gr...@gmail.com>.
On Fri, Dec 21, 2012 at 1:19 AM, Nick Burch <ap...@gagravarr.org> wrote:
> On Thu, 20 Dec 2012, Shane Curcuru wrote:
>>
>> I put the DRAFT on because I originally wrote these for my personal
>> Community Over Code site, and I wanted to ensure the style was appropriate
>> for a path under a.o/foundation, which makes it official.
>
>
> I wonder if a label like "work in progress" might be better suited, if we
> want to indicate in future that something is incomplete but input is
> welcomed?
Only if you tell people who is working on it (to submit patches) and
if the content of the document can be used (or not).
Christian
>
> Nick
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
--
http://www.grobmeier.de
https://www.timeandbill.de
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: How to use an apache webpage
Posted by Nick Burch <ap...@gagravarr.org>.
On Thu, 20 Dec 2012, Shane Curcuru wrote:
> I put the DRAFT on because I originally wrote these for my personal
> Community Over Code site, and I wanted to ensure the style was
> appropriate for a path under a.o/foundation, which makes it official.
I wonder if a label like "work in progress" might be better suited, if we
want to indicate in future that something is incomplete but input is
welcomed?
Nick
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: How to use an apache webpage
Posted by Shane Curcuru <as...@shanecurcuru.org>.
r843246
I put the DRAFT on because I originally wrote these for my personal
Community Over Code site, and I wanted to ensure the style was
appropriate for a path under a.o/foundation, which makes it official.
Since at least Christian seems to like it, I've removed the DRAFT. No,
I didn't get the idea from RBD, it's just a habit I have when I get
something partway done without having time to finish it all the way... 8-)
Thanks for the reminder, will try to cleanup and do the same to the
whole /governance tree over the holidays. Personally, I think they're a
really helpful resource.
- Shane
On 12/20/2012 6:34 AM, Andy Seaborne wrote:
> On 20/12/12 05:33, Joe Schaefer wrote:
>> All webpages we host are works in progress subject to change when
>> better consensus emerges. Please do not affix any labels to the
>> pages describing them as drafts as that only serves to discourage
>> others from working on them. Normative policy documents are few and
>> far between and you will recognize them by their self-descriptions as
>> such.
>>
>> Every interested party is welcome to collaborate with us to produce
>> more informative and accurate webpages through the CMS. Please help
>> out where you can. Our documentation becomes increasingly
>> authoritative as more and more people refer to it in positive ways;
>> ie the best documents wear well over time.
>>
>> HTH Sent from my iPhone
>
> I've always found the draft label confusing and as a newbie, suggesting
> that content is not yet active but will become so at some time. But it
> seems from this thread it means "descriptive" or "advice" or
> "non-normative" in W3C-standards-speak. To me, any non-draft documents
> is documenting current state and subject to change.
>
> Andy
>
>
> ---------------------------------------------------------------------
> 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
Re: How to use an apache webpage
Posted by Andy Seaborne <an...@apache.org>.
On 20/12/12 05:33, Joe Schaefer wrote:
> All webpages we host are works in progress subject to change when
> better consensus emerges. Please do not affix any labels to the
> pages describing them as drafts as that only serves to discourage
> others from working on them. Normative policy documents are few and
> far between and you will recognize them by their self-descriptions as
> such.
>
> Every interested party is welcome to collaborate with us to produce
> more informative and accurate webpages through the CMS. Please help
> out where you can. Our documentation becomes increasingly
> authoritative as more and more people refer to it in positive ways;
> ie the best documents wear well over time.
>
> HTH Sent from my iPhone
I've always found the draft label confusing and as a newbie, suggesting
that content is not yet active but will become so at some time. But it
seems from this thread it means "descriptive" or "advice" or
"non-normative" in W3C-standards-speak. To me, any non-draft documents
is documenting current state and subject to change.
Andy
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org