Skip to content

Commit 5d4c95e

Browse files
author
Jeff McCune
committed
(maint) Update README stating stdlib 4.x supports Puppet 2.7.x
Without this patch there is a disconnect between the documentation in the README and our decision to not merge pull requests into the 4.x series that break compatibility with Puppet 2.7.x For example: @jeffmccune I think the real issue here is that "policy" is out of sync with the documentation. The README claims that 4.x does not support puppet 2.7.x, yet the "policy" is not to merge patches that break 2.7.x. Due to that I'm sure there are a lot of 2.7.x installations out there that have a 4.x version of stdlib installed. That's going to cause a rather rude surprise if some future version of 4.x stops working where a prior minor release was functioning. I'd like to suggest that the documentation be changed to reflect 4.x supporting 2.7.x and that a new major version bump is made when 2.7.x support can in fact be dropped. An alternative solution would be update the README with a note to developers about the kinda/sorta/maybe/fishy/quasi support of 2.7.x. Please also see this discussion: #176 (comment)
1 parent 224b8f9 commit 5d4c95e

File tree

1 file changed

+8
-5
lines changed

1 file changed

+8
-5
lines changed

README.markdown

+8-5
Original file line numberDiff line numberDiff line change
@@ -31,8 +31,9 @@ list of integration branches are:
3131
* v2.1.x (v2.1.1 released in PE 1)
3232
* v2.2.x (Never released as part of PE, only to the Forge)
3333
* v2.3.x (Released in PE 2)
34-
* v3.0.x (Never released as part of PE, only to the Forge)
35-
* v4.0.x (Drops support for Puppet 2.7)
34+
* v3.0.x (Released in PE 3)
35+
* v4.0.x (Maintains compatibility with v3.x despite the major semantic version bump. Compatible with Puppet 2.7.x)
36+
* v5.x (To be released when stdlib can drop support for Puppet 2.7.x. Please see [this discussion](https://github.com/puppetlabs/puppetlabs-stdlib/pull/176#issuecomment-30251414))
3637
* master (mainline development branch)
3738

3839
The first Puppet Enterprise version including the stdlib module is Puppet
@@ -44,7 +45,7 @@ Puppet Versions | < 2.6 | 2.6 | 2.7 | 3.x |
4445
:---------------|:-----:|:---:|:---:|:----:
4546
**stdlib 2.x** | no | **yes** | **yes** | no
4647
**stdlib 3.x** | no | no | **yes** | **yes**
47-
**stdlib 4.x** | no | no | no | **yes**
48+
**stdlib 4.x** | no | no | **yes** | **yes**
4849

4950
The stdlib module does not work with Puppet versions released prior to Puppet
5051
2.6.0.
@@ -60,8 +61,10 @@ supports Puppet 2 and Puppet 3.
6061

6162
## stdlib 4.x ##
6263

63-
The 4.0 major release of stdlib drops support for Puppet 2.7. Stdlib 4.x
64-
supports Puppet 3. Notably, ruby 1.8.5 is no longer supported though ruby
64+
The 4.0 major release of stdlib was intended to drop support for Puppet 2.7,
65+
but the impact on end users was too high. The decision was made to treat
66+
stdlib 4.x as a continuation of stdlib 3.x support. Stdlib 4.x supports Puppet
67+
2.7 and 3. Notably, ruby 1.8.5 is no longer supported though ruby
6568
1.8.7, 1.9.3, and 2.0.0 are fully supported.
6669

6770
# Functions #

0 commit comments

Comments
 (0)