How stable is AsciiDoctor format?

classic Classic list List threaded Threaded
2 messages Options
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

How stable is AsciiDoctor format?

egalitarian
This post was updated on .
Evernote is inconvenient to use because it doesn't support deep note hierarchy.
I was trying to use CommonMark for diary and note-taking. CommonMark seemed ok for those purposes.
I can edit CommonMark in Visual Studio Code and GhostWriter with live preview.
I expect CommonMark to stay stable for a long time because it is a versioned specification.
However, I was drawn to AsciiDoc because it has more features like document inclusion, admonition, and table.
Those features are not necessary in quick note-taking, but they are useful.

It seems that asciidoc is slowly dying and asciidoctor is a different format than asciidoc.

I wonder if I could write diary and take notes in AsciiDoctor and keep it unchanged for decades or even centuries.

Would my AsciiDoctor documents compile without problems after 3 decades? Would they after 100 years?
If AsciiDoctor is likely to introduce breaking changes, is there a stable subset of AsciiDoctor that's not likely to change?
I want long-term document archival.
Ted
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: How stable is AsciiDoctor format?

Ted
This post was updated on .
egalitarian wrote
I wonder if I could write diary and take notes in AsciiDoctor and keep it unchanged for decades or even centuries.

I want long-term document archival.
I'll let someone else speak about the stability of Asciidoctor.

For long-term document archival I look at where we've come from. You can still open a text file and an html file created 20 years ago. So my plan is to preserve my documents in AsciiDoc format.

If someone found the original .adoc files, they could still open them in a text editor and read the documents.

I think using Asciidoctor to output the documents to HTML would also be a good way to archive the files because browsers of the future would probably still be able to render the page.

Another way to think about it this is how can you read a MS-Word-95 document today? I've been successful dredging up text out of some of those files. But if you didn't keep buying MS-Word and converting your documents to the new format, eventually the newer versions of Word would not be able to open older documents.

That's why I've concluded the best way to preserve a file, besides printing it out, is to store it as text. Asciidoctor reads so well as text. Even if Asciidoctor did not exist, the digital document could live on.

( see Dan's response about the goal of Asciidoctor http://discuss.asciidoctor.org/Re-How-stable-is-AsciiDoctor-tp5804.html 

and Dan's response about compatibility http://discuss.asciidoctor.org/Is-backward-compatibility-an-important-goal-of-AsciiDoctor-since-1-5-0-tp5798p5803.html )
- Ted @TedAtCIS
Loading...