Software Documentation

April 4, 2019

Documenting your software doesn't have to suck. We'll hear about great ways to keep your documentation close to your source code, to integrate it into your development lifecycle, and to release it with style.

Next TeamTalk

The Talks

Asciidoctor: Because Writing Docs Does Not Have to Suck

Andres Almiray

Andres Almiray

Talk: Asciidoctor 🇬🇧

Gradle Inc.

About the Talk

Writing documentation is often seen as no fun, but it does not have to be that way! Asciidoc is a member of the microformat markup languages family; like Markdown but with more pizzaz and power. Asciidoctor revolutionizes source doc processing in the JVM by leveraging well-known tools such as Maven and Gradle, you can even call it from the command line as is. In this talk we'll present syntax and dive into the JVM toolset that will let you create great documentation. Come learn why teams around the world are getting excited about Asciidoctor.

About Andres

Andres is a Java/Groovy developer and a Java Champion with more than 20 years of experience in software design and development. He has been involved in web and desktop application development since the early days of Java. Andres is a true believer in open source and has participated on popular projects like Groovy, Griffon, and DbUnit, as well as starting his own projects (Json-lib, EZMorph, GraphicsBuilder, JideBuilder). Founding member of the Griffon framework and Hackergarten community event.

API Docs: Take a Walk on the Client Side

Tobias Anstett

Tobias Anstett


About the Talk

With REST APIs becoming the de facto standard for connecting services and applications, the ability to integrate is vital for the success of any cloud service. Your API Docs can be a powerful enabler for future integrations. This talk introduces OpenAPI and the related tools you need to support your documentation and development process.

About Tobias

Tobias Anstett is Founder of K15t Software GmbH. K15t is a leading Platinum Atlassian Expert in Germany and maker of the Scroll Content Management add-ons for Confluence. Tobias has been developing add-ons for the Atlassian Platform since 2007, and in 2010 this Scroll EPUB Exporter was awarded as the "Best Overall Add-On".

The K15t TeamTalks

We regularly invite speakers to talk about new technologies, services, specific application use cases, and other topics. Talks are generally in English, but most of us also speak German.

Never Miss A TeamTalk

Subscribe to our TeamTalks email list and we keep you up-to-date with our events. We promise. No spam, just events.

Next TeamTalk

Join us at the next TeamTalks event to find out the impact that social connection can have on your team's succ...

Learn more

More TeamTalks

  • Git Together

    Jan 31st, 2019

    Git is the developers first choice for version control system. At our 2nd TeamTalks we have 2 Git experts that...

    Learn more
  • Team Productivity

    June 25, 2019

    Getting a shared understanding helps teams to be more effective whether they are remote or co-located

    Learn more
  • Running the Cloud

    October 17, 2019

    Two Cloud experts will share on how to handle topics such as continuously running a system in the Cloud as wel...

    Learn more

Cookie Policy

We use cookies to create a secure and effective browsing experience and to understand how you use our site.