Development

Onion Launchpad development guidelines and workflow are listed here.

Release procedure

Release cycle workflow.

Version update

Set the version number:

ONION_LAUNCHPAD_VERSION=1.0.0

Register the changes

Update the ChangeLog:

$EDITOR ChangeLog

Commit and tag:

git diff # review
git commit -a -m "Feat: Onion Launchpad $ONION_LAUNCHPAD_VERSION"
git tag -s $ONION_LAUNCHPAD_VERSION -m "Onion Launchpad $ONION_LAUNCHPAD_VERSION"

Push changes and tags. Example:

git push origin        && git push upstream
git push origin --tags && git push upstream --tags

Once a tag is pushed, a GitLab release is created.

Announcement

Announce the new release:

• Post a message to the Tor Forum, using the onion-services-announce tag.
• Send a message to the tor-announce mailing list ONLY in special cases, like important security issues (severity HIGH or CRITICAL).

Template:

Subject: [RELEASE] [Onion Launchpad][] [security] release $ONION_LAUNCHPAD_VERSION

Greetings,

We just released [Onion Launchpad][] $ONION_LAUNCHPAD_VERSION, a landing page
to advertise Onion Services.

[This release fixes a security issue. Please upgrade as soon as possible!]

[Onion Launchpad]: https://onionservices.torproject.org/apps/web/onion-launchpad

# ChangeLog

$CHANGELOG