#asciidoctor

[geekmusthave]

Article: Q&A with Cyrille Martraire on the Book Living Documentation Cyrille Martraire argues that we should rethink how we work with documentation when building software systems — we should embrace documentation that evolves at the same pace as the code.

[iteman]

[Asciidoctor](http://asciidoctor.org/)を使うと、技術文書や手順書などのドキュメントを簡単にHTMLで公開できますが、ドキュメントが多くなると自分の調べたいキーワードが、どのドキュメントに載っている...

[emasters]

Antora generates static documentation sites from AsciiDoc

A static site generator for making documentation sites from one or more versioned content repositories.

A documentation pipeline that enables docs, product, and engineering teams to create, manage, remix, and publish documentation sites composed in AsciiDoc and sourced from multiple versioned content repositories.

See details at https://antora.org/ and get the code at https://gitlab.com/antora/an…

View On WordPress

[geekmusthave]

ASCIIDocFX Getting Powershell as your Windows Terminal.

The Geek have been converted, hallelujah, pass the cmdlets.  The Geek was a self-proclaimed expert at Windows Batch files.  I could get them to sing, dance and tell jokes.  The writing on the wall and Microsoft’s recent lapse in sanity have resulted in PowerShell is available on both Windows and Linux, image that.  This means the Geek uses PowerShell whenever possible so that sometime soon I can…

View On WordPress

[geekmusthave]

Article: Relearning to Learn — InfoQ

For my 30 plus years in tech, I’ve been reading and listening to tech mostly wrong. After in depth investigation into learning strategies I’ve restructured my knowledge acquisition process. Find out how I’ve take control of my learning queue. How I now perform active reading while taking creative notes. And hear how to use reflection…

Like this author of this article Don Denoncourt I also have…

View On WordPress

[bk2204]

So I'm now an official contributor to the Asciidoctor project.  AsciiDoc is a text format designed for easy writing and conversion, and Asciidoctor is a faster, more featureful implementation of the original AsciiDoc program in Ruby.

My most recent patches have been to improve the conversion to DocBook manpages. The output was missing some important elements, and as a result, xsltproc would always output to a file called ".1".

I've also got a set of patches that allow building Git with Asciidoctor. This results in a pleasant 42% speedup of the documentation build time. Since the documentation on the Git website is built using Asciidoctor already, it's useful to be able to test it as part of the Git build process.