Asciidoctor :: Discussion

Re: Breaking changes with 0.1.4?

Posted by mojavelinux on Oct 11, 2013; 10:30pm
URL: https://discuss.asciidoctor.org/Breaking-changes-with-0-1-4-tp757p791.html

On Thu, Oct 10, 2013 at 1:25 AM, glaforge [via Asciidoctor :: Discussion] <[hidden email]> wrote:

On Wed, Oct 9, 2013 at 10:09 PM, mojavelinux [via Asciidoctor :: Discussion] <[hidden email]> wrote:

[...]
I'm sure Guillaume would agree that we are creeping into the realm of language design here. That's one of the reasons I'm so thrilled that Guillaume is part of this community. Guillaume, your expertise on language design will no doubt prove central to the evolution of this syntax!

Oh flattery :-)

;) Oh, but it's more than that. I'm glad just to get to know you and to give you something in return for your hard work.

Consistency is of course very important.

The problem seems that AsciiDoc itself hasn't been all that consistent in the first place, so I guess it puts Asciidoctor in a problematic situation with regards compatibility.

In the short term, yes. Once Asciidoctor reaches a point where it's the most widely adopted implementation, hands down, the plan is to start _defining_ compatibility. I'm already taking a lot of notes for what we'll want to add, improve or drop when we're ready to make a formal specification, based on the experiences flowing through this community.

If there's no interference with and without underscores, I would argue that supporting both the way you mention (through underscore removal basically) is a good compromise. Users not remembering if there's an underscore or not won't be bothered if they make a typo :-) It's quite forgiving! And it's pragmatic.

Exactly. Thanks for sharing that insight. I'll put it on the roadmap then.

-Dan

Dan Allen | http://google.com/profiles/dan.j.allen