#

Note

This documents the development version of NetworkX. Documentation for the current release can be found here.

#

Release Process

• Update the release notes:

  1. Review and cleanup doc/release/release_dev.rst,

  2. Fix code in documentation by running cd doc && make doctest.

  3. Make a list of merges and contributors by running doc/release/contribs.py <tag of previous release>.

  4. Paste this list at the end of the release_dev.rst. Scan the PR titles for highlights, deprecations, and API changes, and mention these in the relevant sections of the notes.

  5. Rename to doc/release/release_<major>.<minor>.rst.

  6. Copy doc/release/release_template.rst to doc/release/release_dev.rst for the next release.

  7. Update doc/news.rst.

• Comment out dev_banner.html in doc/_templates/layout.html.

• Toggle dev = True to dev = False in networkx/release.py.

• Commit changes:

  git add networkx/release.py
  git commit -m "Designate X.X release"
  

• Add the version number as a tag in git:

  git tag -s [-u <key-id>] networkx-<major>.<minor> -m 'signed <major>.<minor> tag'
  

  (If you do not have a gpg key, use -m instead; it is important for Debian packaging that the tags are annotated)

• Push the new meta-data to github:

  git push --tags upstream master
  

  (where upstream is the name of the

  github.com:networkx/networkx repository.)

• Review the github release page:

  https://github.com/networkx/networkx/releases
  

• Publish on PyPi:

  git clean -fxd
  python setup.py sdist bdist_wheel
  twine upload -s dist/*
  

• Update documentation on the web: The documentation is kept in a separate repo: networkx/documentation

  • Wait for the NetworkX Travis Bot to deploy to GitHub Pages

  • Sync your branch with the remote repo: git pull.

  • Copy the documentation built by Travis. Assuming you are at the top-level of the documentation repo:

    # FIXME - use eol_banner.html
    cp -a latest networkx-<major>.<minor>
    ln -sfn networkx-<major>.<minor> stable
    git add networkx-<major>.<minor> stable
    git commit -m "Add <major>.<minor> docs"
    # maybe squash all the Deploy GitHub Pages commits
    # git rebase -i HEAD~XX where XX is the number of commits back
    # check you didn't break anything
    # diff -r latest networkx-<major>.<minor>
    # you will then need to force the push so be careful!
    git push
    

• Increase the version number

• Uncomment dev_banner.html in doc/_templates/layout.html.

• Toggle dev = False to dev = True in networkx/release.py.

• Update major and minor in networkx/release.py.

• Commit and push changes:

  git add networkx/release.py
  git commit -m "Bump release version"
  git push upstream master
  

• Update the web frontpage: The webpage is kept in a separate repo: networkx/website

  • Sync your branch with the remote repo: git pull. If you try to make github when your branch is out of sync, it creates headaches.

  • Update _templates/sidebar_versions.html.

  • Edit _static/docversions.js and commit

  • Push your changes to the repo.

  • Deploy using make github.

• Post release notes on mailing list.

  • networkx-discuss@googlegroups.com