Incorporating some of the HOWTOs
I'm becoming more and more convinced that at least some of the HOWTOs should become part of the Python documentation. Motivation:
* A sizable number of the documents are about Python as a whole, and therefore would be more naturally part of Python's tree than a separate one.
* If the documents were in the Python CVS tree, changes would be glanced at by the 30-odd people on the python-checkins list as opposed to the 8 people on the pyhowto-checkins list
* They would get increased visibility from being on www.python.org/doc/ .
My candidates for addition would be (in decreasing order of suitability):
* The "What's New" documents, which are like really verbose release notes.
* python-dev, which discusses how Python is developed, where to report bugs, and that sort of thing.
* "Editor Configuration", which discusses how to configure various editors (vi, Emacs, Alpha, CodeWright, jed, ....) for editing Python code.
* The Python Advocacy HOWTO, which should be dusted off and updated to serve as a sort of advocacy/marketing FAQ.
The rest of the HOWTOs are smaller and more task-specific (rexec, curses); a case could be made for creating Doc/howto/, but I won't argue that case right now.
Reactions (particularly from Fred)?
--amk (www.amk.ca) "The future" has arrived but they forgot to update the docs. -- R. David Murray, 9 May 2000
(The random number generator strikes again!)
Andrew Kuchling akuchlin@mems-exchange.org writes:
Reactions (particularly from Fred)?
I'm worried about the question what the primary source of such documents is; I think any change in location should be accompanied with a removal of the documents from their current location (in case of Web documents, ideally with a redirect to the new location).
Regards, Martin
On Wed, Mar 06, 2002 at 07:12:02PM +0100, Martin v. Loewis wrote:
documents is; I think any change in location should be accompanied with a removal of the documents from their current location (in case of Web documents, ideally with a redirect to the new location).
Certainly. My long-term goal is to shut down the py-howto SourceForge project and get all the documents rehoused somewhere else.
--amk (www.amk.ca) I'm the Doctor. Who are you and why are you shooting at me? -- The Doctor, in "The Face of Evil"
Certainly. My long-term goal is to shut down the py-howto SourceForge project and get all the documents rehoused somewhere else.
python.org is at your service.
--Guido van Rossum (home page: http://www.python.org/~guido/)
participants (3)
-
Andrew Kuchling -
Guido van Rossum -
martin＠v.loewis.de