The Puppet Labs Issue Tracker has Moved:

This issue tracker is now in read-only archive mode and automatic ticket export has been disabled. Redmine users will need to create a new JIRA account to file tickets using See the following page for information on filing tickets with JIRA:

Bug #3593

Document how Forge modules should be versioned

Added by Igal Koshevoy over 5 years ago. Updated about 3 years ago.

Status:ClosedStart date:04/20/2010
Priority:NormalDue date:
Assignee:Ryan Coleman% Done:


Category:documentationSpent time:-
Target version:-
Keywords: Affected URL:

We've Moved!

Ticket tracking is now hosted in JIRA:


We’re now pushing for Puppet and related projects. Forge modules should follow the same practice.

To that end, we should include documentation on how to properly version modules (with information about SemVer) and make that documentation visible when a user is publishing a module or release.

I suggest we document the how and why of versioning here:

Related issues

Related to Puppet Forge - Bug #3592: Site should not reinvent version matching and ordering Closed 04/20/2010


#1 Updated by Igal Koshevoy over 5 years ago

  • Status changed from Unreviewed to Accepted

#2 Updated by Igal Koshevoy over 5 years ago

  • Assignee deleted (Igal Koshevoy)

#3 Updated by James Turnbull almost 5 years ago

  • Assignee set to Nick Fagerlund

#4 Updated by Ryan Coleman over 3 years ago

  • Subject changed from Documentation should explain the release version number's ordering to Document how Forge modules should be versioned
  • Description updated (diff)
  • Affected URL set to

Nick, do you still want to be assigned to this or would you prefer I make a pull against modules_publishing.html?

#5 Updated by Nick Fagerlund over 3 years ago

  • Assignee changed from Nick Fagerlund to Ryan Coleman

If you have a pretty good idea what you want in there, I would lovvvve a pull request.

I suggest you make the versioning instructions a new H3 header underneath the “release a new version” section at the bottom.

#6 Updated by Ryan Coleman about 3 years ago

  • Status changed from Accepted to Closed

We’re covering this pretty well now. Sorry for neglecting updates to this ticket.

Also available in: Atom PDF