Doc suggestions (was: Why "class exceptions" are not deprecated?)

Fredrik Lundh fredrik at pythonware.com
Thu Mar 30 18:19:04 CEST 2006


Gerard Flanagan wrote:

> > I've added some notes to the front-page.  feel free to tweak/clarify (or post
> > comments here or on the site).
> >
> > for now, I think it's worth trying to keep the text clean and reasonably read-
> > able at all times, and use the comment function to add questions/suggestions
> > (more wikipedia than c2, in other words).
>
> I like it!

thanks!

the feedback this far has been very positive, and there's been quite a
few good contributions from several contributors.  makes me wonder why
I haven't done this before (could it be that infogami didn't exist last time
I looked into edit-through-the-web stuff ? ;-)

> Can a page be easily recovered if someone decided to delete it?

yup.  infogami keeps a full history.

> Can anyone add a page? How to do this?

just add a [[link]] to a page (or comment), and click on the link to get an
offer to create the missing page.  or just hack the URL.  see:

    http://howto.infogami.com/createnewpages

however, I would prefer if we could keep the current overall structure intact
for now.  (but adding new pages for other purposes is perfectly okay, though;
also see the "if you want to make major changes" note on the front page).

> Would it be a good idea to make every subsection of a page linkable?
> eg.
>
>     http://pytut.infogami.com/node6.html#the_range_function
>
> then a list of the subsections at the top of each page? For example
> I've added such a list at http://pytut.infogami.com/node6.html

the subsections should absolutely be linkable in the finished python.org
product, but that can be automated (either in the yet-to-be-written export
scripts, or by some wikipedia-style infogamibot maintenance droid... (1))

</F>

1) dear lazyweb/lazynet: does anyone have some time to spare on figuring
out how to log into infogami from a simple python script.  standard library
only, preferrably.






More information about the Python-list mailing list