[Distutils] FAQ (was: Re: Bootstrap script for package management tool in Python 2.7)
robert.kern at gmail.com
Mon Mar 29 18:38:05 CEST 2010
On 2010-03-29 11:29 AM, anatoly techtonik wrote:
> On Mon, Mar 29, 2010 at 5:46 PM, Tarek Ziadé<ziade.tarek at gmail.com> wrote:
>> On Mon, Mar 29, 2010 at 4:41 PM, anatoly techtonik<techtonik at gmail.com> wrote:
>>> On Mon, Mar 29, 2010 at 5:18 PM, Tarek Ziadé<ziade.tarek at gmail.com> wrote:
>>>>> I can see any FAQ. To me the FAQ is something that could be posted to
>>>>> distutils ML once a month to reflect current state of packaging. It
>>>>> should also carry version number. So anybody can comment on the FAQ,
>>>>> ask another question or ask to make a change.
>>>> The guide was built by people in the community, and contains a
>>>> "current state of packaging" section.
>>>> We are trying to keep it accurate with what we are doing.
>>>> You have a mailing list where you can ask question, and you are
>>>> welcome to contribute changes.
>>>> Adding a "FAQ" containing links to sections in the guide, or a
>>>> summarized answered is a good idea though !
>>> If do not post a link to exact chapter in the FAQ as a full response
>>> to user's question at least once a week then it is not a FAQ.
>> I don't understand what's "once a week" means.
>> For me a FAQ is a list of questions. We add a new question everytime someone
>> ask it and it doesn't exists. We correct the answers when they evolve.
>> No matter when these events occur.
> For example, http://www.faqs.org/faqs/happyman-faq/
> Note that this is an email and it has version.
> If FAQ is posted monthly or weekly - you may refer people to the
> relevant mail in archive. Everybody can just reply to a FAQ email to
> ask a new question or correct an omission.
This style of maintaining a FAQ has long since fallen out of fashion. No one
seems to want to volunteer to maintain a FAQ this way, so I suggest dropping the
"I have come to believe that the whole world is an enigma, a harmless enigma
that is made terrible by our own mad attempt to interpret it as though it had
an underlying truth."
-- Umberto Eco
More information about the Distutils-SIG