diff --git a/pep-0101.txt b/pep-0101.txt
index 9f4f50abb..73a5a13c9 100644
--- a/pep-0101.txt
+++ b/pep-0101.txt
@@ -234,9 +234,88 @@ How to Make A Release
$ ssh creosote.python.org mkdir $TARGET
$ scp *-$VERSION.* creosote.python.org:$TARGET
- XXX What's needed to describe posting the documentation on the
- website should be added here, or there should be a link to a
- document in the python.org site management documentation.
+ ___ For final releases, publish the documentation on python.org.
+ This must be done by someone with write access to the python.org
+ CVS repository.
+
+ Start by creating a new directory and filling it with the
+ standard boilerplate. $VERSION is the same as for uploading the
+ documentation, above; $OLDVERSION is the most recently published
+ version on the site.
+
+ $ cd .../pydotorg/doc/
+ $ mkdir $VERSION
+ $ cvs add $VERSION
+ $ cd $OLDVERSION
+ $ cp .cvsignore Makefile index.ht download.ht ../$VERSION
+ $ cd ../$VERSION
+ $ cvs add .cvsignore Makefile *.ht
+
+ Now make the following edits:
+
+ - in Makefile, change the value of ROOT_OFFSET to doc/$VERSION
+
+ - in index.ht, change:
+ - the version number to $VERSION in two places: the Title:
+ header, and the
at the top of the page
+ - the release date, in the at the top of the page
+ - if the minor release number changed (for example, from 2.3
+ to 2.4), the title and link to the "What's New" document
+ (search for "whatsnew")
+
+ - in download.ht, change:
+ - the version number to $VERSION in two places: the Title:
+ header, and the at the top of the page
+ - the release date, in the at the top of the page
+ - if the minor release number changed (for example, from 2.3
+ to 2.4), the title and link to the "What's New" document
+ (search for "whatsnew")
+ - replace the large table of downloads with the content of the
+ pkglist.html file generated by the documentation build
+ process
+
+ Now, the web content has all been prepared, but there's still
+ some dancing to do to make it all work right. To be safe, we
+ can commit the new files to CVS, but we're *not* ready to
+ install them on the site yet:
+
+ $ cvs commit -m \
+ "Add website content for Python $VERSION documentation."
+
+ Log into creosote.python.org using SSH and unpack a copy of the
+ documentation into place:
+
+ # on creosote:
+ $ cd /ftp/www.python.org/doc
+ $ tar xjf \
+ /ftp/ftp.python.org/pub/python/doc/$VERSION/html-$VERSION.tar.bz2
+ $ mv Python-Docs-$VERSION $VERSION
+
+ Now head back to your pydotorg checkout on your workstation, and
+ push website content into place:
+
+ $ cd .../pydotorg/doc/$VERSION
+ $ make install
+
+ Point your browser at this URL and check it out:
+
+ http://www.python.org/doc/$VERSION/
+
+ There are three more changes that need to happen in the
+ top-level doc/ directory of the website content. The first of
+ these can happen any time after what's already happened in this
+ process, and the last two should happen as soon as the release
+ announcement has been made.
+
+ At this time, edit the versions.ht file in doc/ to make add the
+ new release at the top. The previous latest release should drop
+ down to the top of the long list of released versions, and the
+ new release should replace the previous most recent release.
+ There should be a blank line between the link to the development
+ documentation and the most recent release, and another blank
+ line between the most recent release and the long list of older
+ releases. (Is should be fairly easy to figure this out while
+ looking at the file.)
___ Thomas grabs the HTML to build the Windows helpfile.
The HTML files are unpacked into a new src/html directory, and
@@ -461,6 +540,27 @@ How to Make A Release
Feel free to remove any old news items.
+ ___ Make the last two changes to the documentation area on
+ python.org. (Remember those from the documentation items above?
+ It's time now.)
+
+ In your pydotorg checkout, edit the file doc/index.ht to update
+ to the right version number and release date. Commit the
+ changes to CVS and push the file to the website:
+
+ $ cd .../pydotorg/doc/
+ $ make install
+
+ This will cause the doc/index.html file to claim to point to the
+ new docs, but they won't. Run (don't walk!) to
+ creosote.python.org, and update a symlink in the doc/ tree:
+
+ # on creosote:
+ $ cd /ftp/www.python.org/doc/
+ $ rm current && ln -s $VERSION current
+
+ Good. Stop running.
+
Now it's time to do some cleaning up. These steps are very important!
___ If you made a non-maintenance branch, be sure to merge it into