Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [asciidoc-lang-dev] On the evolution of Asciidoc species ... erm specifications


Yes I forgot to mention, documents with no versions specified should be considered to be version 1.0 which is likely to have the minimum changes from the status quo.  This will allow an official deprecation period for changes to the standard that require document changes.


On Tue, 2 Mar 2021 at 04:44, Jay Bryant <jbryant@xxxxxxxxxx> wrote:
Hi, all,

Do we want a default version, for all the existing Asciidoc files that have no version specified? I don't want to touch all of Spring's docs merely to add a version attribute. As part of other maintenance, sure, but otherwise, no.

Even better would be some way to identify the highest compatible version that an unversioned document can use, but that could get complicated in a hurry.


From: asciidoc-lang-dev <asciidoc-lang-dev-bounces@xxxxxxxxxxx> on behalf of Dan Allen <dan@xxxxxxxxxxxxxx>
Sent: Monday, March 1, 2021 1:35 AM
To: AsciiDoc developer discussions <asciidoc-lang-dev@xxxxxxxxxxx>
Subject: Re: [asciidoc-lang-dev] On the evolution of Asciidoc species ... erm specifications

Thanks for bringing this up. I just want to reply briefly to say that it is indeed to plan to version the spec, and semantic versioning is the logical choice. (Although this point has been made in several SC meetings, I see that it's absent from the program plan). You have provided more detail than I have stated anywhere, so I will be sure to incorporate that mapping into the information about the development workflow we'll be sending to the list shortly (and if not that email, certainly somewhere in the documents for the project).

> The document could specify the version with an attribute in the heading such as:

Indeed, this is the only way I've been able to think of allowing the language to evolve without forcing all existing documents to migrate. We may be able to come up with something shorter, but we'd still need some sort of indicator.

Best Regards,


Dan Allen, Vice President | OpenDevise Inc.
Pronouns: he, him, his
Content ∙ Strategy ∙ Community
asciidoc-lang-dev mailing list
To change your delivery options, retrieve your password, or unsubscribe from this list, visit

Back to the top