All entries for Developer documentation
Can software developers and technical communicators write documentation together?
parson supported the Digital Industries, Factory Automation and Information Management division at Siemens in establishing a standardized authoring process. read more
Staff portrait: Gernot Baumann, Technical Communicator
Gernot Baumann has been working as a technical communicator at parson since 2018. In our blog, we talked to him about his experience as a career changer, trends in technical communication, his current work projects, and more. read more
Software documentation, a strange new world?
Digitalization is increasing the need for software documentation. This article provides an overview of the characteristics of software documentation and is geared toward beginners. We will try to give an answer to the question what good software documentation is and what technical authors need to know to create it. read more
API documentation – What software engineers can teach us
When asking software engineers about API documentation, you soon find out that there are two groups. The first group is convinced that good code does not require any explanation. Members of the second group frequently read documentation and even enjoy writing it. You also find out that software engineers have completely different opinions and approaches when it comes to the layout, presentation, and contents of a perfect API documentation. read more
Developer documentation: the necessary evil?
Anna M. is a software engineer. She has just started working for a company that develops custom add-ons for an out-of-the-box financial software solution. For developing the add-ons, Anna is supposed to use the API of the software. Little does Anna know about the API's structure, its interfaces, and its functionality. read more