Skip to content

Commit e41a6ff

Browse files
miharpclaude
andcommitted
docs: fix Hiera nav label and stale deprecation content
- nav: rename the duplicate "Hiera" item to "About Hiera" - hiera_config_yaml_3/4: replace the stale "remove support in Puppet 6" notices with accurate text (deprecated, still supported in 8.x for backward compatibility, use v5) - hiera_migrate: add a note that Hiera 5 is the default since Puppet 5 and most 8.x users do not need the migration guide Signed-off-by: Michael Harp <mike@mikeharp.com> Assisted-by: Claude Opus 4.8 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 173d5c1 commit e41a6ff

4 files changed

Lines changed: 5 additions & 3 deletions

File tree

_data/nav/openvox_8x.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -255,7 +255,7 @@
255255
link: "designing_convenient_roles.html"
256256
- text: Hiera
257257
items:
258-
- text: Hiera
258+
- text: About Hiera
259259
link: "hiera_intro.html"
260260
- text: Interactive Hiera Demo
261261
link: "hiera_demo.html"

docs/_openvox_8x/hiera_config_yaml_3.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ This version of Puppet supports three formats for hiera.yaml --- you can use any
2929

3030
## Important: version 3 is deprecated
3131

32-
Version 3 of hiera.yaml is deprecated, and we plan to remove support for it in Puppet 6.
32+
Version 3 of hiera.yaml is deprecated and not recommended. OpenVox 8.x still supports it for backward compatibility, but you should use [version 5][v5] instead.
3333

3434
More importantly, it has some major problems:
3535

docs/_openvox_8x/hiera_config_yaml_4.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ v4 | Environment and module layers | Deprecated. A transitional format, used
2222

2323
## Important: version 4 is deprecated.
2424

25-
Version 4 of hiera.yaml is deprecated, and we plan to remove support for it in Puppet 6.
25+
Version 4 of hiera.yaml is deprecated and not recommended. OpenVox 8.x still supports it for backward compatibility, but you should use [version 5][v5] instead.
2626

2727
More importantly, version 4 can't use some of Hiera 5's best new features, like custom backends.
2828

docs/_openvox_8x/hiera_migrate.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,8 @@ title: "Upgrading to Hiera 5"
2121
[custom_backend_system]: ./hiera_custom_backends.html
2222
[functions_puppet]: ./lang_write_functions_in_puppet.html
2323

24+
> **Note:** Hiera 5 has been the default since Puppet 5 (2017), so most OpenVox 8.x users already use it and do not need this guide. It remains here for the rare case of migrating very old Hiera 3 data.
25+
2426
Upgrading to Hiera 5 offers some major advantages. A real environment data layer means changes to your hierarchy are now routine and testable,
2527
using multiple backends in your hierarchy is easier and you can make a custom backend.
2628

0 commit comments

Comments
 (0)