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.

Filter by
Sorted by
Tagged with
15
votes
2answers
968 views

Preferred word for “preferred”, “target”, “chosen” in end user support documentation

I'm having trouble finding and sticking to one word to indicate whatever value the user intends to use with my instructions. For example: Select your preferred printer. I'm wondering what ...
6
votes
3answers
245 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
85 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
684 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
3k 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
260 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
4k 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
165 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 ...
14
votes
4answers
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 ...