Skip to content

Instantly share code, notes, and snippets.

View bucketsize's full-sized avatar

bucketsize bucketsize

1 follower · 5 following
View GitHub Profile
@bucketsize
bucketsize / asciidoc.asciidoc
Last active December 11, 2015 23:58

Asciidoctor

Ryan Waldron, Dan Allen

Asciidoctor is a native Ruby processor for converting AsciiDoc source files and strings into HTML 5, DocBook 4.5 and other formats.

Installation

You can install the Asciidoctor RubyGem using the gem command:

@bucketsize
bucketsize / testdoc-jb.asciidoc
Last active December 11, 2015 23:58
sample .asciidoc article for tryouts

How to document gracefully

jb …​ trying out some stuff.

Avoid jazzy authoring tools

  • stay clear of using bloated sofwares that make jazy promises.

  • that use classical UI to produce good documentents.

  • that use complicated keyboard shortcuts.