This page was last updated on .

Checklists » Creating a new project

  1. Create local repository:
    1. cp -r hexstream-project-template new-project
    2. cd new-project/master
    3. rm -rf .git
    4. git init
    5. Remove, rename and add files as necessary.
    6. Update file contents as necessary (especially README if there is one).
    7. git add .
    8. git commit -m 'Initial commit.'
  2. Create repository on github:
    1. Create repository, usually reusing the description from README.
    2. Follow on-screen instructions for "existing repository" (add remote, push)
    3. Refresh page.
  3. Update worknotes:
    1. Add link to project in the appropriate category.
    2. Add project entry in the appropriate table.
    3. Cross-reference from appropriate metaprojects.
    4. Update "last updated" date.
    5. Commit, push to live (website), push to origin (github).

Checklists » Making a new release

This is way too manual. Fortunately, I'm not making releases often yet.

  1. Update repo:
    1. Make sure the .asd indicates a suitable new version number.
    2. Reference relevant github issues from the commit(s), if applicable.
    3. Create an appropriate version tag. Make sure to push it too.
  2. Make tarball:
    1. cp -r project-name/master project-name-version
    2. ./make-tarball.sh project-name-version
    3. Remove version from tarball name.
    4. rm -rf project-name-version
    5. Upload tarball to S3, make sure it's publicly accessible. Download to test.
  3. Update website:
    1. Update "latest versions" page. Update the tarball.
    2. Update "timeline" page.
    3. Update the factsheet for the library page.
    4. Make an announcement on the main page if deemed newsworthy enough.
    5. Don't forget to update the "page last modified" dates!