prototype-doc-workflow.txt

#####
## INITIAL CONFIGURATION
#####

# Fork sstephenson/prototype on GitHub
# Go to this url and click the fork button. This will create a prototype 
# repository under your GitHub account.

http://github.com/sstephenson/prototype

# Clone your fork to a local directory.
# I put it in my OSX apache path so that I can view it via
# http:/localhost/~dand/prototype:

cd ~/Sites
git clone git@github.com:{ ... your github username ... }/prototype.git
cd prototype

# Add the prototype documentation branch as a remote on your prototype repo.
# The documentation branch is maintained by samleb:

git remote add -t documentation samleb git://github.com/samleb/prototype.git

# Pull samleb docs repo down

git fetch samleb

# Branch samleb docs off to your own documentation branch
# This version will always match the official documentation branch,
# you will not work on it directly, but _branch it_ and work on that:

git checkout --track -b documentation samleb/documentation

#####
## FOR EACH TICKET
#####

# Make sure you are on _your_ documentation branch.
# You can always verify this by calling `git branch`. The one with the `*` in
# front of it is the repository that you're currently on.

git checkout -b port_{ ... my ticket ... }_{ ... ticket number ... } documentation


# Claim a ticket in lighthouse
# Work on the ticket ...
# Build the pdoc docs with rake to make sure you didn't break anything:

rake doc

# OR, build just a section (dom, ajax, lang, etc)

rake doc SECTION=dom

# Commit your changes to your doc branch.
# Replace the content within and including the curly braces with
# real information:

git add path/to/file.js
git comment -m 'doc: {... ticket name ...} [#{...ticket number...} state:fixed_in_branch]'

# Push your committed changes to _your_ patches remote repo on GitHub:

git push origin port_{ ... my ticket ... }_{ ... ticket number ... }

# Update the lighthouse ticket. Remove "committed" tag, add "patched" tag
# and paste in the link to your commit on GitHub.

# Go back to samleb docs and pull the latest to make sure you're still up to date.

git checkout documentation
git pull samleb

# Find another ticket to work on.