From 9e7522ee611796e568aa58dc0bc878ac8a1c471c Mon Sep 17 00:00:00 2001 From: "Jason R. Coombs" Date: Mon, 16 Jun 2014 08:12:08 -0400 Subject: Started work on a developer guide. --- docs/developer-guide.txt | 41 +++++++++++++++++++++++++++++++++++++++++ docs/development.txt | 1 + 2 files changed, 42 insertions(+) create mode 100644 docs/developer-guide.txt (limited to 'docs') diff --git a/docs/developer-guide.txt b/docs/developer-guide.txt new file mode 100644 index 00000000..fbee5e67 --- /dev/null +++ b/docs/developer-guide.txt @@ -0,0 +1,41 @@ +================================ +Developer's Guide for Setuptools +================================ + +If you want to know more about contributing on Setuptools, this is the place. + + +.. contents:: **Table of Contents** + + +---------------------- +Repository and Tracker +---------------------- + +... + +.. git mirror + +----------------- +Authoring Tickets +----------------- + +... + +------------------------ +Submitting Pull Requests +------------------------ + +Use Mercurial bookmarks or Git branches. Use incremental commits. Minimize +stylistic changes. + +------------------- +Semantic Versioning +------------------- + +Setuptools follows ``semver`` with some exceptions: + +- Uses two-segment version when three segment version ends in zero +- Omits 'v' prefix for tags. + +.. explain value of reflecting meaning in versions. diff --git a/docs/development.txt b/docs/development.txt index ba927c73..e35ba39b 100644 --- a/docs/development.txt +++ b/docs/development.txt @@ -30,6 +30,7 @@ setuptools changes. You have been warned. .. toctree:: :maxdepth: 1 + .. developer-guide formats releases -- cgit v1.2.1