editor Archives - SUSE Communities

November 20, 2018 5:18 pm

2,135 views

Yes We Can: Technical Documentation with DAPS for DocBook and AsciiDoc

This article has been contributed by Frank Sundermeyer, Project Manager of the SUSE Documentation Team. If you are working in technical communication, banking on DocBook for your documentation projects comes with many advantages. However, over the past few years, software documentation projects started to move from DocBook […]

Tags: AsciiDoc, community, content management system, contribution, DAPS, Developer, DocBook Authoring and Publishing Suite, DocBook XML, documentation, editor, engineer, engineering, enterprise solutions, Linux, openSUSE, Profiling, publication process, publishing, software, software architect, stylesheet, SUSE Linux Enterprise, Technical communication, technical writer, technical writing, toolchain, Validation, XML

Categories: Technical Solutions

By: chabowski

July 10, 2018 4:52 pm

1,611 views

The Brains Behind the Books – Part I: Carla Schroder

This article has been contributed by Carla Schroder, Technical Writer at the SUSE Documentation Team. It is the first in a planned series of articles focusing on SUSE Documentation and the great minds that create the manuals, guides, quick starts, and many more helpful documents. […]

Tags: books, documentation, editor, education, FOSS, Linux, Linux books, OSS, teaching, technical writing

Categories: Expert Views

By: chabowski

October 25, 2017 10:12 am

1,039 views

An Alien Looking From the Outside In – Main Take-Aways After a Year in Documentation

Not too long ago, mid of September, I was attending this great Documentation Conference, Write the Docs, which – like many other conferences this year – took place in beautiful Prague. The WTD org team somehow decided that my session proposal “An Alien Looking From the Outside In – Main Take-Aways After a Year […]

Tags: content, content conference, DAPS, DocBookXML, documentation, documentation event, editor, SOAP!, technical documents, technical writing, Tools, Write The Docs

Categories: Expert Views

By: chabowski

June 29, 2017 10:04 am

9,931 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 […]

Tags: AsciiDoc, content, DocBook, document formats, documentation, editor, Emacs, Gedit, GitHub, guides, JEdit, manuals, markup language, Notepad+, oXygen, Sphinx, Sublime, technical documentation, technical writing, text modularization, versioning, Vi, Vim