DOC: semver.rst: Examples (TODO)

[westurner]

https://bugs.launchpad.net/pbr/+bug/1629199

[westurner]

Is there a way to include a git short-sha without a Development version?

1.0.0.c999.g95a9beb
1.0.0..g95a9beb ?

[westurner]

Is there a guideline for this? The build metadata is arbitrary, but, as always, ISO8601 doesn't sort unless the timezone is always the same (which isn't the case in regions with daylight savings time), so the only sortable ISO8601 options are:

-0000
+0000
-Z
+Z

Alternatively, Unix time (seconds since the epoch) is sortable.

[westurner]

I suppose the #headings here could be normalized to the wording from PEP440:

• "PEP 440 -- Version Identification and Dependency Specification"

  https://www.python.org/dev/peps/pep-0440/

[westurner]

It may also be worth mentioning that semantic_version also parses and sorts semantic versions and has API docs?

• | PyPI: https://pypi.python.org/pypi/semantic_version
• | Src: https://github.com/rbarrois/python-semanticversion
• Tests: https://github.com/rbarrois/python-semanticversion/tree/master/tests
• Is semantic_version Semver3.0 compatible?
  • ... This is built from EARL reports: http://json-ld.org/test-suite/reports/

[openstack-gerrit]

Thank you for contributing to openstack-dev/pbr!

openstack-dev/pbr uses Gerrit for code review.

If you have never contributed to OpenStack before make sure you have read the
getting started documentation:
http://docs.openstack.org/infra/manual/developers.html#getting-started

Otherwise please visit
http://docs.openstack.org/infra/manual/developers.html#development-workflow
and follow the instructions there to upload your change to Gerrit.