Alan Docs Format Inquiry

[Christan Winslett]

Good evening from Texas, USA!

It's been a while since my last activity in the project, I do apologize for my extended absence.

I've resumed my effort to port the Alan Cookbook to Asciidoc recently and I am now about 50% done!

Also, I just so happened to use Asciidoc for a number of documents at work and I can now say that I am quite comfortable with the quirks of the format!

However, my experience leads me to wonder why certain design decisions were made in in the document style. Below is an example of what is used throughout the other documents:

1. == Alan Doc Style
2. 
   
3. [source,alan]
4. -------------------------------------------------------------------------------------------------------------------------
   
5. The door IsA Door
6.     Name door
7. End The door.
8. --------------------------------------------------------------------------------------------------------------------------
   
9. 
   
10. [NOTE]
11. ==============================================================
12. This is a very helpful note about Alan!
13. ==============================================================
    

But the typical Asciidoc style would be:

1. == Typical Asciidoc Style
2. 
   
3. [source,alan]
4. ----
5. The door IsA Door
6.     Name door
7. End The door.
8. ----
9. 
   
10. NOTE: This is a very helpful note about Alan!

The former requires a lot of pasting and the lines distract heavily from the content, whereas the latter is very clean and it is easy to tell what each element is doing.

So I'm curious about why the former style is used as opposed to the latter, is there any particular reason for this preference?

Thanks,

C. Winslett