chabowski
By: chabowski

June 29, 2017 10:04 am

2,176 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 manual knows how important it is […]

Read More


chabowski
By: chabowski

May 3, 2017 3:30 am

14,743 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, and carries equal rank […]

Read More