Stack Exchange Network

Stack Exchange network consists of 175 Q&A communities including Stack Overflow, the largest, most trusted online community for developers to learn, share their knowledge, and build their careers.

Visit Stack Exchange

Questions tagged [user-guides]

This tag should be used for questions about creating a guide that is supposed to help users understand something, such as questions about the typical language used in such documents or questions about tools and software that can support the creation of such as document.

6
votes
3answers
236 views

Formatting of Text in Technical Writing (Procedure Writing)

In a procedure, when describing a UI component, we use the bold font to represent UI components. We also match the text with the letter case of the UI component. But do we need to match the font style ...
14
votes
3answers
65 views

Instruction manuals: should the end-user be addressed directly (passive vs imperative)?

Manuals come with virtually any appliance, and they typically target the end-user. Among other things (legal specifications, part numbers…), these documents contain specific instructions on what to do ...
7
votes
1answer
601 views

Format keyboard keys in documents

I'm writing a guide to give step-by-step instructions to complete some tasks on the computer. At some points, I need to indicate pressing keys on the keyboard; how may I format the letter/symbol to ...
9
votes
2answers
2k views

How should I document a database schema?

I am going to be writing some user-facing documentation for a database that visitors can query. That is, the people writing queries are not the ones who created the database; they can come in, look ...
7
votes
1answer
249 views

How do I approach rewriting an entire user guide in an agile environment?

I'm tasked with rewriting an entire user guide that hasn't been updated for years at a company and I am the only technical writer on the team. Only release notes were sent out all these years. The ...
8
votes
3answers
1k views

Best Tool to Create User Guides

We are planning to create a user guide for internal use only. It's 150-page document in Word for a self-developed SW tool. The user guide will require constant update. No translation is needed. We ...
6
votes
2answers
3k views

Present tense in user manuals

I am writing a user manual for an IT system. And inside the user manual I have sentences such as: Users can delete Servers that do not have Customers assigned to them. Is the use of present-...
7
votes
2answers
162 views

Standards for representing user interaction

I am responsible for developing internal IT documentation but have only begun my scratching the surface on technical documentation. Is there a standard or best practice for the following: Example 1:...
10
votes
6answers
7k views

Demo data in screenshots! What are the best practice?

My question is related to best practices of making screenshots for end-user documentation. Particularly, is there universal information for filling in forms in the software and after that making ...
13
votes
3answers
3k views

In end user documentation, should screenshots come before or after the text that references them?

The end user documentation I'm writing makes use of screenshots (and partial screenshots) to show the user what I'm referring to in procedural instructions or conceptual explanations of the software. ...
6
votes
1answer
2k views

Is there a style / terminology guide for Android OS application documentation?

This relates to my earlier question: Habits and routines for my first tech writing job I will be involved with writing documentation for an Android OS business application. Is there an Android style ...