yard-yaml 0.1.1 is available.

yard-yaml is a RubyGem that plugs into YARD and helps Ruby projects document YAML files alongside the rest of their API docs. It can discover .yml, .yaml, and Citation File Format (.cff) files, convert them to HTML pages, and expose inline documentation tags such as @yaml and @yaml_file.

This release is mostly about making the converter more resilient around file encodings, plus keeping the generated project tooling current.

What changed

The main user-facing fix is in Yard::Yaml::Converter.from_file.

In 0.1.1 it now:

• preserves valid UTF-8 text
• scrubs malformed UTF-8 safely in non-strict mode
• rejects binary-ish inputs cleanly instead of raising raw encoding crashes

That matters for documentation pipelines because YAML-like files are often edited by different tools, copied between systems, or generated by automation. A documentation build should fail clearly when the input is not text, and it should handle recoverable encoding issues predictably when strict mode is disabled.

Documentation and CI maintenance

This release also includes generated project maintenance from the current kettle-jem template:

• refreshed generated project tooling
• refreshed CI support
• refreshed documentation support
• generated CI coverage for rdoc ~> 6.11 and >= 7.0

For contributors working across sibling repositories, 0.1.1 also adds documentation_local.gemfile support under KETTLE_RB_DEV, which makes local documentation development smoother in a multi-repo workspace.

Quick usage

Install the gem:

bundle add yard-yaml

Then enable the YARD plugin in .yardopts:

--plugin yaml

From there, yard-yaml can participate in yard doc generation and convert YAML documents, including .cff files, into documentation output.

The plugin also supports inline docstring tags:

# @yaml
# ---
# title: Example YAML
# description: This is an example YAML block.
# ---

And file references:

# @yaml_file path/to/example.yml

Release links

• Release: https://github.com/galtzo-floss/yard-yaml/releases/tag/v0.1.1
• Changelog compare: https://github.com/galtzo-floss/yard-yaml/compare/v0.1.0...v0.1.1
• RubyDoc: http://rubydoc.info/gems/yard-yaml
• Source: https://github.com/galtzo-floss/yard-yaml

Thanks to everyone building Ruby documentation tooling and keeping project docs close to the code they describe.