Hi all,
while updating the TurboGears web site today, I involuntarily deleted
the TG 2 docs on the website, because the web site doc deployment script
("pushstaging.sh") deletes everything which is not in the
/website/dist/site dir (which is build from the sources in
/website/newdocs and /website/site-resources).
I had some trouble resurrecting the docs because the instructions in
trunk/docs/README.txt where somewhat unclear and incomplete and nowhere
(neither in SVN or on the server) was it documented what files were
actually copied to the "2.0" directory of the website. I updated the
README.txt a bit to clarify some things. Also, as I discovered after
uploading the re-generated docs, the website had two files (tg.css,
tg.png), which were not in SVN, and I had to restore them from the
server backup (I hope I caught all missing files).
This brings up a few issues:
- The deployment script needs to be fixed to leave the "2.0" and "1.0"
directories of the web site alone - done.
- The missing files need to be added to SVN (I added tg.css and tg.png,
anything else?).
- The TG 2.0 maintainers (you know who you are!) need to document the
procedure to upload the TG 2.0 docs on the website.*
- If you do anything on the server, please read the documents in
"admin_docs" in the homedirectory on the server first! The procedure for
updating the website is docuented in the "README-Release" file.
I could have just restored the whole "2.0" directory from the backup,
but I would prefer that we have a reliable setup to generate the docs
from scratch.
Chris
* I just did the following, I hope this was correct:
# in trunk/docs
# note the trailing slash on "html/"
rsync -rv --update _build/html/ \
turbogears.org:webapps/htdocs/2.0/docs
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"TurboGears Docs" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at
http://groups.google.com/group/turbogears-docs?hl=en
-~----------~----~----~----~------~----~------~--~---
