[Pythonmac-SIG] Where should the FAQ go?

Skip Montanaro skip at pobox.com
Mon Jul 28 17:47:59 EDT 2003


    Jack> 1. Simply plug into the existing general Python FAQ, start a
    Jack>    decent Macintosh section and fix the existing Mac questions
    ...

    Jack> (1) has the advantage of being the least work. But it has a
    Jack>     serious drawback: the current FAQ as it exists is still very
    Jack>     much geared towards the unix-crowd: lots of questions on
    Jack>     building Python and such.  A Mac-specific FAQ could solve
    Jack>     that, but would not only be more work for the maintainer(s)
    Jack>     but also for the end user (because s/he may have to look in
    Jack>     two places for answers).

Option 1 also has the advantage that it becomes a one-stop shop for Python
questions.  People won't have to realize there's a Mac-specific FAQ and find
it.  Andrew Kuchling (cc'd on this message) is in the midst of converting
the existing Python FAQ from faqwiz to docutils so it will also be easier to
update.  There's a version in the pydotorg CVS as doc/FAQ.txt, but it isn't
yet available from the website.

Skip



More information about the Pythonmac-SIG mailing list