<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" />
<title>[BuddyPress][13747] trunk/docs/contributor: Contributor docs: migrate the Version Numbering codex page</title>
</head>
<body>
<style type="text/css"><!--
#msg dl.meta { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dl.meta dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer, #logmsg { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; }
#msg dl a { font-weight: bold}
#msg dl a:link { color:#fc3; }
#msg dl a:active { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { white-space: pre-line; overflow: auto; background: #ffc; border: 1px #fa0 solid; padding: 6px; }
#logmsg { background: #ffc; border: 1px #fa0 solid; padding: 1em 1em 0 1em; }
#logmsg p, #logmsg pre, #logmsg blockquote { margin: 0 0 1em 0; }
#logmsg p, #logmsg li, #logmsg dt, #logmsg dd { line-height: 14pt; }
#logmsg h1, #logmsg h2, #logmsg h3, #logmsg h4, #logmsg h5, #logmsg h6 { margin: .5em 0; }
#logmsg h1:first-child, #logmsg h2:first-child, #logmsg h3:first-child, #logmsg h4:first-child, #logmsg h5:first-child, #logmsg h6:first-child { margin-top: 0; }
#logmsg ul, #logmsg ol { padding: 0; list-style-position: inside; margin: 0 0 0 1em; }
#logmsg ul { text-indent: -1em; padding-left: 1em; }#logmsg ol { text-indent: -1.5em; padding-left: 1.5em; }
#logmsg > ul, #logmsg > ol { margin: 0 0 1em 0; }
#logmsg pre { background: #eee; padding: 1em; }
#logmsg blockquote { border: 1px solid #fa0; border-left-width: 10px; padding: 1em 1em 0 1em; background: white;}
#logmsg dl { margin: 0; }
#logmsg dt { font-weight: bold; }
#logmsg dd { margin: 0; padding: 0 0 0.5em 0; }
#logmsg dd:before { content:'\00bb';}
#logmsg table { border-spacing: 0px; border-collapse: collapse; border-top: 4px solid #fa0; border-bottom: 1px solid #fa0; background: #fff; }
#logmsg table th { text-align: left; font-weight: normal; padding: 0.2em 0.5em; border-top: 1px dotted #fa0; }
#logmsg table td { text-align: right; border-top: 1px dotted #fa0; padding: 0.2em 0.5em; }
#logmsg table thead th { text-align: center; border-bottom: 1px solid #fa0; }
#logmsg table th.Corner { text-align: left; }
#logmsg hr { border: none 0; border-top: 2px dashed #fa0; height: 1px; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<div id="msg">
<dl class="meta" style="font-size: 105%">
<dt style="float: left; width: 6em; font-weight: bold">Revision</dt> <dd><a style="font-weight: bold" href="http://buddypress.trac.wordpress.org/changeset/13747">13747</a><script type="application/ld+json">{"@context":"http://schema.org","@type":"EmailMessage","description":"Review this Commit","action":{"@type":"ViewAction","url":"http://buddypress.trac.wordpress.org/changeset/13747","name":"Review Commit"}}</script></dd>
<dt style="float: left; width: 6em; font-weight: bold">Author</dt> <dd>imath</dd>
<dt style="float: left; width: 6em; font-weight: bold">Date</dt> <dd>2024-03-02 02:32:59 +0000 (Sat, 02 Mar 2024)</dd>
</dl>
<pre style='padding-left: 1em; margin: 2em 0; border-left: 2px solid #ccc; line-height: 1.25; font-size: 105%; font-family: sans-serif'>Contributor docs: migrate the Version Numbering codex page
Props vapvarun
Closes https://github.com/buddypress/buddypress/pull/242</pre>
<h3>Modified Paths</h3>
<ul>
<li><a href="#trunkdocscontributormanifestjson">trunk/docs/contributor/manifest.json</a></li>
<li><a href="#trunkdocscontributorprojectREADMEmd">trunk/docs/contributor/project/README.md</a></li>
</ul>
<h3>Added Paths</h3>
<ul>
<li><a href="#trunkdocscontributorprojectversionnumberingmd">trunk/docs/contributor/project/version-numbering.md</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunkdocscontributormanifestjson"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/docs/contributor/manifest.json</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/docs/contributor/manifest.json 2024-03-02 02:13:27 UTC (rev 13746)
+++ trunk/docs/contributor/manifest.json 2024-03-02 02:32:59 UTC (rev 13747)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -12,6 +12,12 @@
</span><span class="cx" style="display: block; padding: 0 10px"> "parent": null
</span><span class="cx" style="display: block; padding: 0 10px"> },
</span><span class="cx" style="display: block; padding: 0 10px"> {
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ "title": "Version Numbering",
+ "slug": "version-numbering",
+ "markdown_source": "../contributor/project/version-numbering.md",
+ "parent": null
+ },
+ {
</ins><span class="cx" style="display: block; padding: 0 10px"> "title": "How a release cycle works?",
</span><span class="cx" style="display: block; padding: 0 10px"> "slug": "about-release",
</span><span class="cx" style="display: block; padding: 0 10px"> "markdown_source": "../contributor/project/release/README.md",
</span></span></pre></div>
<a id="trunkdocscontributorprojectREADMEmd"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: trunk/docs/contributor/project/README.md</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/docs/contributor/project/README.md 2024-03-02 02:13:27 UTC (rev 13746)
+++ trunk/docs/contributor/project/README.md 2024-03-02 02:32:59 UTC (rev 13747)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -3,4 +3,4 @@
</span><span class="cx" style="display: block; padding: 0 10px"> - Project organization
</span><span class="cx" style="display: block; padding: 0 10px"> - [Release cycle](./release/README.md)
</span><span class="cx" style="display: block; padding: 0 10px"> - Commit access
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-- Version numbering
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+- [Version Numbering](./version-numbering.md)
</ins></span></pre></div>
<a id="trunkdocscontributorprojectversionnumberingmd"></a>
<div class="addfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Added: trunk/docs/contributor/project/version-numbering.md</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- trunk/docs/contributor/project/version-numbering.md (rev 0)
+++ trunk/docs/contributor/project/version-numbering.md 2024-03-02 02:32:59 UTC (rev 13747)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -0,0 +1,29 @@
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+# Version Numbering
+
+## Overview
+
+Understanding the version numbering system is crucial for developers and site administrators to manage updates, compatibility, and features effectively. BuddyPress follows a semantic versioning system similar to WordPress, designed to convey the significance of each release and the changes it includes.
+
+## BuddyPress Version Structure
+
+BuddyPress versions are expressed in a `major.minor.patch` format, where:
+
+- **Major:** Significant releases that introduce new features, improvements, or substantial changes to the core functionality. Major releases may also include changes that could affect compatibility with themes or plugins.
+- **Minor:** These versions focus on bug fixes, security patches, and minor enhancements that do not introduce major features or significant changes. Minor releases ensure stability and security without altering the core functionality dramatically.
+- **Patch:** Patch versions address urgent bug fixes, security vulnerabilities, or minor issues that cannot wait for a scheduled minor release. Patches are essential for maintaining the security and performance of the platform between minor updates.
+
+## Understanding Version Numbers
+
+- **Initial Release (X.0):** The first version of a major release, such as 1.0, 2.0, etc., signifies a significant milestone in the software's development, introducing major features and changes.
+- **Feature Enhancements (X.Y):** Versions like 2.1, 2.2, etc., represent minor releases that add enhancements or improvements to existing features without overhauling the core functionality.
+- **Maintenance and Security (X.Y.Z):** Versions such as 2.1.1, 2.1.2, etc., are patch releases focused on fixing specific issues to improve security and stability.
+
+## WordPress Compatibility
+
+BuddyPress aims to maintain compatibility with a range of WordPress versions, ensuring broad support across various WordPress installations. The versioning strategy allows BuddyPress to align closely with WordPress's release cycle, facilitating seamless integration and compatibility.
+
+## Best Practices for Administrators
+
+- **Stay Updated:** Regularly update to the latest BuddyPress version to benefit from new features, security patches, and performance improvements.
+- **Test Updates:** Before applying updates on a live site, especially major releases, test them in a staging environment to ensure compatibility with your site's themes and plugins.
+- **Monitor Release Notes:** Review the release notes for each new version to understand the changes, improvements, and any potential impact on your site.
</ins></span></pre>
</div>
</div>
</body>
</html>