chabowski
By: chabowski

June 29, 2017 10:04 am

4,994 views

DocBook, AsciiDoc or Sphinx – Choices, Choices…! A Comparison of Document Formats

The following article has been contributed by Janina Setz, Trainee at SUSE. The original article has been published in German at DataCenter Insider. A big “Thank You” to chief editor Ulrike Ostler for the permission to publish the article in English at the SUSE blog.   Anyone who has ever used an instruction […]

Read More


chabowski
By: chabowski

May 3, 2017 3:30 am

14,937 views

Documentation is Teaching, and Teaching is Everything

The following article has been contributed by Carla Schroder, Technical Writer at the SUSE Documentation Team.     Documentation is notorious for being in a persistent Schrödinger state. Everyone wants good documentation, but nobody reads it. Writing good documentation is "easy", but nobody wants to write it. Documentation is absolutely necessary, […]

Read More