AsciiDocsy Release History (Converse)

AsciiDocsy can now be installed as a gem. Add it to your Gemfile under :jekyll_plugins and indicate the theme in the site.theme parameter. See the docs for details.

All Bootstrap and AsciiDocsy CSS is now sourced as Sass under the _sass/ path.

While the source of AsciiDocsy technical documentation remains in the AsciiDocsy theme repo under _docs/, and the attributes-data source has moved to lib/asciidocsy/data/, the files that configure the AsciiDocsy documentation deployment have moved to a distinct repo.

This move was mainly to model a proper docs-as-code deployment chain for the AsciiDocsy docs themselves. The AsciiDocsy theme repository is treated as a Git submodule of that documentation repo, so the docs repo always has ready access to the documentation and data directories of the subject repo.

The new repo is at: https://github.com/DocOps/asciidocsy-docs-www

Because the Iconic skin imposed an ugly box under the page header that was not obviously fixable, Iconic will no longer be an option for users to select in the AsciiDocsy demo site skin changer. The Iconic skin source itself may be removed as early as v0.3.0. Mostly this note was just an excuse to use the deprecation tag, also added in this release.

Changelog entries with one and only one doc link will now hyperlink directly to that doc URL. Those with 2 or more doc entries still link to the Release Note entry for the same change, but now all changes with 2+ doc entries will always appear under Release Notes, even if they have no note property, so their multiple docs links can appear.

A full suite of versioning options now enables amending the DOM, swapping tokens, toggling classes, and tabbing panes. Also resolves Issue #9.

AsciiDocsy provides a templates and a YAML format for generating release notes and/or a changelog. If you are reading this as HTML or PDF, you are most likely looking at one such generated release history, for AsciiDocsy itself. Documentation is forthcoming; this feature may change without notice prior to 1.0.

The flagship implementation of the ReleaseHx minimum-viable product is the AsciiDocsy Release Notes and Changelog itself.

A full suite of versioning options now enables amending the DOM, swapping tokens, toggling classes, and tabbing panes.

Both searches were drawing off the same index, so we switched them up into site search and subject search.

Basic documentation site uses AsciiDocsy theme under _docs/ directory. Also introduces rudimentary Config API reference platform/DSL.