This repository/project facilitates planning for and participation in Asciidoctor-related “programming” at Write the Docs 2019. Asciidoctor is an official sponsor of Writing Day 2019 (Sunday, 19 May), but all of the activities discussed here are officially part of WTD 2019.
We are a group of AsciiDoc aficionados/evangelists eager to share our open-source ways with everyone who loves creating great technical documentation. These are some ways we hope to enhance the WTD 2019 experience for ourselves and other participants.
Asciidoctor is a proud sponsor of WTD Writing Day 2019. As a nonprofit open-source provider, Asciidoctor will have a strong presence throughout the conference. On Writing Day, volunteers will offer tutorials and workshops on common sticking points, from setting up an environment to working with Git to deploying a site sourced in AsciiDoc and generated by Antora or Jekyll. Writing Day Activities are being planned under the writing day and session issues tags.
We should not nominate more than one Asciidoctor-specific Lightning talk, if that; and we should accept that the committee might reject it on the basis that it might look like favoritism. But we certainly have learned countless lessons in our years doing docs-as-code that are not exactly “on-brand”.
Recommendations for 5-minute, general-audience lessons go under the Lightning Talks Brainstorm issue.
These are 30-minute roundtables, usually very informal. They can give a topic a deep dive, involving discussion or demos. There’s no telling how many people will show up, but we can print up some logo-emblazoned cards to make them stand out.
Suggestions for and discussion of Unconference session topics goes under the unconference and session labels.
We intend to offer this repo and GitHub project space as a playground for the whole WTD2019/Asciidoctor experience. Participants in our Writing Day programming will be able to branch or fork this repo and issue merge requests with new content.
This project was kicked off by members of the teams behind Asciidoctor, Antora, and LiquiDoc — fully open-source tools intended to make the AsciiDoc markup language more powerful and accessible. If you want to get involved, let us know how!
This repository is maintained collaboratively by OpenDevise, Codewriting, and other contributors, released like the rest of our toolchain, under The MIT License.