docs(vim-openvox): major honesty and completeness pass

- Added clear 'Current Status' section in doc/openvox.txt
- Added 'Differences from vim-puppet' section
- Updated introduction and style guide claims to match reality + ongoing port
- README: Made 'Replacing Other Plugins' table accurate and added status note
- Removed overpromises on indentation/alignment while highlighting active improvements

Part of the full gold-standard alignment effort.

Assisted By: Grok AI (Sonny)

Author: cvquesty

README.md

@@ -9,8 +9,8 @@ plugins with a single, cohesive solution built around the official
 | Feature | Description |
 |---------|-------------|
 | **Syntax Highlighting** | Full Puppet 8 language — resource types, 90+ built-in functions, data types, heredocs, string interpolation, regex, operators, EPP templates |
-| **Indentation** | 2-space soft tabs with improved resource/conditional handling (actively being aligned to gold-standard vim-puppet behavior) |
-| **openvox-lint** | Async linting with puppet-lint (preferred) + openvox-lint, quickfix + signs, auto-fix |
+| **Indentation** | 2-space soft tabs with significantly improved resource and conditional handling (actively ported toward gold-standard vim-puppet behavior) |
+| **Arrow Alignment** | Manual + block alignment for `=>` (improved safety against strings/comments) |
 | **metadata-json-lint** | Validates module `metadata.json` files |
 | **yamllint** | Lints Hiera YAML data files |
 | **Omni-completion** | Context-aware completion for types, attributes, functions, variables, ensure values |
@@ -118,15 +118,16 @@ let g:openvox_fold = 1
 
 ## Replacing Other Plugins
 
-vim-openvox is designed to replace:
+vim-openvox aims to be a strong modern replacement. Current replacement quality:
 
-| Old Plugin | vim-openvox Replacement |
-|------------|----------------------|
-| `puppet-syntax-vim` / `vim-puppet` (rodjek) | Full syntax, indent, ftdetect, ftplugin |
-| `vim-puppet-lint` | Async puppet-lint + quickfix |
-| Syntastic (puppet checker) | Async puppet-lint + puppet validate |
-| ALE (puppet linters) | puppet-lint, metadata-json-lint, yamllint |
-| Tabular / vim-easy-align (for `=>`) | Built-in arrow alignment |
+| Old Plugin                  | Replacement Quality in vim-openvox                  | Notes |
+|-----------------------------|-----------------------------------------------------|-------|
+| `puppet-syntax-vim` / rodjek/vim-puppet | Good (syntax, folding, basic indent)               | Indent & alignment still being hardened to full gold-standard level |
+| `vim-puppet-lint` + Syntastic/ALE | Excellent (async, multi-linter, fix, signs)       | One of the strongest parts |
+| Tabular / vim-easy-align    | Good (manual + block alignment)                     | Safer now (skips strings/comments) |
+| Various snippet plugins     | Basic boilerplate generators                        | Good starting point; pair with UltiSnips/LuaSnip if desired |
+
+Full feature parity on indent/alignment with the gold-standard vim-puppet is the current active focus.
 
 To disable old plugins with Pathogen:
 ```vim

doc/openvox.txt

@@ -29,7 +29,7 @@ vim-openvox is a comprehensive Puppet IDE plugin for Vim that provides:
 
   - Full Puppet 8 syntax highlighting (resource types, functions, data types,
     operators, heredocs, interpolation, EPP templates)
-  - Style-guide-compliant indentation (2-space soft tabs, arrow alignment)
+  - 2-space soft tabs with improving resource/conditional indentation (actively being aligned to gold-standard behavior)
   - Async linting via puppet-lint, metadata-json-lint, and yamllint
   - Context-aware omni-completion (Ctrl-X Ctrl-O)
   - Code navigation (go-to-definition, block jumping)
@@ -42,6 +42,39 @@ It is designed to replace multiple Puppet-related plugins with a single,
 cohesive solution following the official Puppet Style Guide:
 https://help.puppet.com/core/8/Content/PuppetCore/style_guide.htm
 
+CURRENT STATUS                                          *openvox-status*
+
+vim-openvox is under active development toward gold-standard quality
+(closely tracking the battle-tested vim-puppet plugin).
+
+Current state (as of v0.9+):
+- Excellent: Syntax, async linting (puppet-lint + others), completion,
+  navigation, snippets/boilerplate, EPP support.
+- Good & improving rapidly: Indentation and arrow alignment (major
+  refactors have been applied to match vim-puppet behavior).
+- Documentation is being brought into alignment with actual behavior.
+
+For the absolute latest on indent/alignment robustness, see the
+git history or the companion `vim-puppet` repository (the reference
+implementation this plugin is being aligned to).
+
+DIFFERENCES FROM VIM-PUPPET (RODJEK)                     *openvox-vim-puppet*
+
+vim-openvox started as a rebrand/fork of the excellent rodjek/vim-puppet
+and its modern successors. The goal is to keep the best parts while
+adding OpenVox-specific branding, expanded linting (openvox-lint), and
+deeper integration features.
+
+Key differences and current alignment status:
+- Indentation and arrow alignment: Being actively ported to match the
+  battle-tested logic from the vim-puppet gold standard.
+- Linting: Stronger multi-linter async support (puppet-lint + openvox-lint
+  + metadata + yamllint).
+- Naming: All commands, functions, and variables use the `openvox` prefix
+  instead of `puppet`.
+- Documentation: Being updated to be strictly accurate about current
+  capabilities (see |openvox-status|).
+
 ==============================================================================
 2. INSTALLATION                                         *openvox-installation*