dahu / LearnVim

A Suggested Path for Learning Vim
419 stars 22 forks source link

Update README.md #14

Closed Atcold closed 9 years ago

Atcold commented 9 years ago

Better README.md with proper Markdown formatting

dahu commented 9 years ago

Thanks for the fixes. I switched from Markdown to Asciidoc in my github repos a while back. When I updated LearnVim's README recently, I_ass_umed it was in Asciidoc format and obviously didn't test the changes. :-/

Atcold commented 9 years ago

Oh :anguished: Why did you switched from Markdown to Asciidoc? In this PR I did some minor formatting changes only...

dahu commented 9 years ago

Asciidoc is much better than Markdown

I use Asciidoc in all the doco places I can, including creating lecture notes and slides. Github had very rudimentary Asciidoc support until Asciidoctor. After that, I started switching over.

On 15 September 2015 at 20:44, Alfredo Canziani notifications@github.com wrote:

Oh [image: :anguished:] Why did you switched from Markdown to Asciidoc ?

— Reply to this email directly or view it on GitHub https://github.com/dahu/LearnVim/pull/14#issuecomment-140375678.

Atcold commented 9 years ago

Lecture notes?!?! Are you teaching? May I see an example? How is AsciiDoc superior to Markdown? Last thing, you said 'didn't test the changes. :-/'... Changes from?

dahu commented 9 years ago

A small sample of how I create lecture slides: https://gist.github.com/dahu/9aad62389038c3967fe3

http://asciidoctor.org/docs/what-is-asciidoc/

I recently updated Learnvim's README prior to your edits, and when I made those changes I assumed the document was in Asciidoc. I didn't generate a local rendering to test my changes (make sure they looked right). I also failed to check on github itself. Rushing.

On 16 September 2015 at 21:46, Alfredo Canziani notifications@github.com wrote:

Lecture notes?!?! Are you teaching? May I see an example? How is AsciiDoc superior to Markdown? Last thing, you said 'didn't test the changes. :-/'... Changes from?

— Reply to this email directly or view it on GitHub https://github.com/dahu/LearnVim/pull/14#issuecomment-140747000.

Atcold commented 9 years ago

And you think that AsciiDoc is superior to Markdown? Why?