Clarified Numbering
Project: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/repo Commit: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/commit/89843345 Tree: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/tree/89843345 Diff: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/diff/89843345 Branch: refs/heads/master Commit: 898433458a47c4a93240ec4c18e6ec94d1d3a71a Parents: e04b38e Author: Duncan Godwin <duncan.god...@cloudsoftcorp.com> Authored: Wed Mar 9 15:38:01 2016 +0000 Committer: Duncan Godwin <duncan.god...@cloudsoftcorp.com> Committed: Wed Mar 9 15:38:01 2016 +0000 ---------------------------------------------------------------------- _plugins/page_structure.rb | 1 + contributing/ordering.md | 6 ++++-- 2 files changed, 5 insertions(+), 2 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/brooklyn-docs/blob/89843345/_plugins/page_structure.rb ---------------------------------------------------------------------- diff --git a/_plugins/page_structure.rb b/_plugins/page_structure.rb index d2e419b..b1697bd 100644 --- a/_plugins/page_structure.rb +++ b/_plugins/page_structure.rb @@ -64,6 +64,7 @@ module PageStructureUtils yaml.each do |i| if i.instance_of? String position[i] = $major+"."+$minor.to_s + $minor += 1 else # get the key for this type of child defining_param = getDefiningParameterFromHash(i) http://git-wip-us.apache.org/repos/asf/brooklyn-docs/blob/89843345/contributing/ordering.md ---------------------------------------------------------------------- diff --git a/contributing/ordering.md b/contributing/ordering.md index ff2a0f9..428360c 100644 --- a/contributing/ordering.md +++ b/contributing/ordering.md @@ -14,8 +14,10 @@ For inline children, sourced using `check_directory_for_children: true`, this `s The format for `section_position` is that of software versioning, i.e `A.B... Z` where A, B etc are numbers of decreasing value. Position `1.1.0` would appear before version `1.0.4` for example. This allows an infinite number of sub pages between each `section_position`. -Any un-versioned pages are automatically numbered to follow on from the last numbered page, or `1.1` if no pages are yet numbered. For -example, if a numbered page, `1.4` is followed by a non-numbered page, the non-numbered page would be auto-numbered as `1.4.1`. +Any un-versioned pages are automatically numbered to add a new minor version from the last page if that was numbered or increment the minor +if it was not. If no pages are yet numbered, the numbering is started at `1.1`. For example, if a numbered page, `1.4` is followed by a +non-numbered page, the non-numbered page would be auto-numbered as `1.4.1`. If this page is followed by another non-numbered page it would +be auto-numbered as `1.4.2`. For example, a set of children pages numbered like this: