Questions tagged [technical-writing]

Documentation, tutorials, training, user guides, installation guides, design documents, and all other types of technical documentation in any domain (not just software).

Filter by
Sorted by
Tagged with
4
votes
1answer
672 views

What is the process of creating a word using Latin and Greek word parts?

I am trying to create a word that means "division of a single God", but I am having some trouble. If I understand correctly, any word must have a suffix, root and prefix, but sometimes I ...
2
votes
2answers
56 views

Can we use 'then' after a 'when'?

I know about the logical expression of 'if --- then', such as 'If the temperature reaches or exceeds a particular temperature, then the kettle will turn off.' But what about situations that involve '...
0
votes
1answer
43 views

Should you cite the document you're refuting or only the documents you use to prove your argument in a research paper?

Should you cite the document you're refuting or only the documents you use to prove your argument in a research paper? I am wondering what's the consensus on this, because in my opinion, it doesn't ...
2
votes
2answers
91 views

How a psychiatrist must talk?

I wrote a scene of a psychiatrist talking to a traumatized child, and I read and read it several times but still not convinced and satisfied with it. Are there any book recommendations or extracts ...
0
votes
1answer
57 views

How do you create new words if latin suffixes and prefixes are not sufficient in allowing you to create a new word you want to create?

How do you create new words if latin suffixes and prefixes are not sufficient in allowing you to create a new word you want to create? What are the things people use to make up for a lack of latin ...
0
votes
0answers
27 views

Best way to explain references to historic currency

What is the best way to explain the pre-decimal British Pound in a text that has multiple references to it. I already have something written to explain how to convert from pre-decimal to post-decimal ...
0
votes
1answer
47 views

Capitalize “million” when using as a unit

When you write "1 Million", should it be "1 Million" or "1 million"? I would assume capital based on the symbol for mega being 'M'.
0
votes
1answer
28 views

Should there be a space between quantitative units?

I understand that the SI standard for units is to have a space between the number and unit: Unit of measurement and formatting https://physics.nist.gov/cuu/Units/checklist.html But, does this apply ...
1
vote
2answers
87 views

Database documentation verb choice: If “fieldname” has/contains/is/displays

I'm trying to find the right verb for database documentation. I have to write a lot of these and it is very long; so I am working for a consistent and reusable way to phrase this. What I have now: ...
0
votes
1answer
72 views

Writing about a large Application Programming Interface

I would like to write a tutorial for a large Application Programming Interface, let me call that way. It is a library of many elements, in the thousand range. Obviously, only part of it is frequently ...
0
votes
1answer
43 views

Mapping relationships between topics in a non-fiction series

I am working on a series of episodes that will be made into individual videos to explain different technologies and how they interrelate at different levels within a specific application domain (the ...
3
votes
1answer
91 views

What is the proper format for filetype extensions in technical writing?

We are writing a collaborative paper that will include various examples of data types. When stating the data type file extension, how should it be presented? For example, "The platform will be ...
0
votes
2answers
93 views

How do I write a strong hook for an argumentative essay?

The scenario is to write a hook for an argumentative essay. The topic is "Can tigers be kept in zoos?", as they have less space in zoos compared to nature, and for other reasons they should ...
3
votes
2answers
131 views

Should I use more transition words? [closed]

I just wrote a blog post, and then I went to publish it on our team blog. The Wordpress instance for the team has this "Yoast SEO" plugin. Among other things, it judges my writing style: I'...
4
votes
1answer
82 views

Mixed numerals and words in a list

In APA style, we generally use the word for numbers less than 10 and the numeral for numbers equal or greater than 10. However, I am editing a sentence that has predominantly single-digit numbers and ...
1
vote
2answers
90 views

Hyphen, Comma or Brackets? What should I use?

Which would be the proper style for a scientific publication: It is required that a, b, and, depending on a and b, c is given. It is required that a, b, and - depending on a and b - c is given. It ...
1
vote
3answers
87 views

How to credit an artist for adding minor details to a vehicle?

How do you credit someone for coming up with a general design of a vehicle without designing every little aspect about it? Let's say you make a video and you want to credit the person who came up with ...
1
vote
1answer
33 views

When is it appropriate to include citations in a guidebook?

I'm working on a series of self-published guidebooks aimed at teaching tech skills for people who aren't tech literate. My only prior experiences writing nonfiction have been research papers for ...
5
votes
2answers
334 views

Is it confusing for the reader to encounter in a novel the same language written with two different letters? Tamazight language as an example

I'm writing a fictional novel in English and I have a mythical character who speaks a combo of English-Tamazight (80% English). For those who don't know, it's the native language of all North African ...
0
votes
2answers
88 views

Writing about the historical relationship between math and physics

I'm not sure if this is best suited for Writing SE, or perhaps one of the science SE's. In any case, feel free to move this if fitting. I've been tasked with writing a 20-30 page paper on the history ...
0
votes
0answers
30 views

How should I structure a small non-fiction book/paper about a groundbreaking product/invention?

I want to write a book/paper about an invention I have thought and developed conceptually. But I'm really struggling on what I should include in it and how to structure the information. Any ...
0
votes
1answer
35 views

See examples 1 and 2 in section X - or - See section X, examples 1 and 2

Which form is more common when referring to examples (or, for example, tables)? Some text (see examples 1a and 2e in X). or Some text (see X, examples 1a and 2e). X is the title of the section. ...
-2
votes
2answers
56 views

Is it correct to write: “Your payment's being processed”? [closed]

Is it correct to write: "Your payment's being processed" ?
0
votes
1answer
89 views

When vs. If vs. In situation where

An excerpt from Microsoft Writing Style Guide, which I'm trying to follow: Use if to express a condition, use whether to express uncertainty, and use when for situations that require preparation or ...
6
votes
2answers
246 views

How do you write a story with someone else overseas?

My friend and I have wanted to write a story together for a while now. But she lives in a different country, so we are just confused on how we can do this over calls. Because I know that we can't call ...
1
vote
3answers
139 views

Referencing figures, tables, sections and chapters: When to capitalize and when to use lower case letters

I know this question has been asked before, but I am still confused. That’s why I am asking again, but in a detailed way. In a scientific work, a master’s thesis for example, you will insert figures ...
1
vote
3answers
166 views

Engineer who wants to improve their writing from scratch

To expand on the title, I am about to finish my engineering degree. However, I haven't really written an essay for the past ten years. The main reason was that I focused all my attention on maths-...
0
votes
2answers
52 views

Section headings: “to check…” vs. “checking”

I have a technical document which consists of the following sections: 1. Assignment statements 2. Concatenation 3. Data types 4. To check whether key exists 5. To retrieve value 6. To check whether ...
3
votes
1answer
77 views

How to list main ideas in a conclusion chapter without being repetitive with the wording?

In the conclusions chapter of my book (technical, non fiction writing) I want to go over the main ideas I addressed throughout the entire book, as a reminder for the reader and really drive in some of ...
0
votes
2answers
61 views

ShareLaTeX or OverLeaf templates to write a book to be self-published on Amazon

I'm planning to write a book and eventually self-publish it online through Amazon (I haven't decided which platform on Amazon yet, but Kindle seems reasonable). The book will contain mostly texts, but ...
1
vote
1answer
154 views

Zero-that clause (noun clause with that)

After omitting "that" from a that-clause, is the clause still dependent? Or, does doing this turn it into an independent clause? For example: Before: "I suggested that she not go there." After: "I ...
3
votes
2answers
75 views

How to include figures and images in body text

I am writing a text (following MHRA style if that makes a difference) that refers to several images throughout, but I am unsure how to include them in my body text in terms of writing style. Does it ...
1
vote
1answer
37 views

Methodologies to organise writing/copy/editing tasks

This question is all about methodologies to handle the workload efficiently for a freelance who deals with copy/editing of documents/articles. In my branch (IT development) we have Agile Methodologies ...
3
votes
4answers
121 views

How do I avoid using punctuation inside quotation marks in technical writing?

As a computer programmer, I comment my code. For example: The following lines are dependent on "source 1" and "source 2". "Source 2" is a user login and password. Overall, the purpose is to ...
-1
votes
1answer
59 views

What software do they use to create textbooks or board game manuals? [closed]

I'm wondering if there is some free software in which I could quite easily compose a book with a lot of images, something like textbooks for children for learning foreign languages (an example: https:/...
2
votes
1answer
47 views

mentioning verbatim sentence of another research

Is it possible to use a verbatim sentence of another research in our own studies? I, as an undergraduate psychology student who doesn't have any research experience, have heard that this is not ...
1
vote
2answers
80 views

Book recommendation for keeping writing specific / concrete

My job requires formal writing, however after self-review, I found that my writing does not have enough substance. This was confirmed as feedback from higher-ups implied that I use too many phrasal ...
1
vote
0answers
24 views

How do you quote a quote? [duplicate]

There's this sentence from Marie Kondo’s book, The Life-Changing Magic of Tidying Up: The Japanese Art of Decluttering and Organizing that I want to use as a title of my project, and I'm not sure if I ...
0
votes
2answers
90 views

Past or present tense when describing a well-known method in the description of an experiment?

I am describing an experiment for a scientific paper. In this experiment, I use a very well-known technique which I briefly describe, similar to the following variant (#1): In this experiment, we ...
0
votes
1answer
43 views

Is “and” or “or” better in this sentence?

When I was writing a manual, I wrote a sentence like example no.1 below. Is it natural to use an "or" like the bolded ones in the sentence? Or it is better to use "and" like example no.2? 1 You ...
1
vote
2answers
100 views

How do you transcribe a person's tone (i.e. someone whose speech is rude and/or attacking)?

I've been having great difficulty with transcribing an individuals "tone" in my meeting notes!! For context: Recently I've been charged with transcribing an incredibly tense litigious meeting. My ...
1
vote
1answer
65 views

When to write (see Section …) or simply (Section …)?

I am writing a technical paper and would like to refer to a previous section in brackets. I have seen it done both ways: Things are like this and that (see Section ...). Stuff is stuff (Section ...). ...
0
votes
0answers
40 views

Constructing a standardized form for a collection of technical manuals

I've been reading several articles about the use of voice within technical writing (both passive and active) and would like feedback and guidance on the proposed content structure. Use Case I plan on ...
2
votes
2answers
96 views

Can MS Word perform single-source help authoring?

My company is using Microsoft Word to manage thousands of documents that ultimately end up publishing only to a couple outputs: primarily PDF but also some web and we're moving toward an app. We need ...
-2
votes
1answer
60 views

Software or Softwares [closed]

It seems to me that softwares is incorrect. I am of the opinion that software is partitive. I try to use some software or piece of software. Do you think it is incorrect to say softwares?
-3
votes
1answer
89 views

What is UX writing? [closed]

What is UX writing? I am a writer and a UX designer by trade. I hear a lot about UX writing being the next big thing. Should I specialize in this area?
7
votes
1answer
2k views

Can you legally write a book based on technical concepts that someone else’s coined?

Is there any issues with writing a book and publishing it that is based on topics and concepts that the technical industry previously coined? Several books have been written on the topics, I just ...
4
votes
1answer
55 views

What to do when API objects and UI names are different?

This question is in reference to API documentation. Say the name of an object is "Action" in the backend, but "Step" in the UI. We cannot rename objects. My approach is to explain that Action = Step ...
1
vote
1answer
28 views

How to reference Other Sections in a document

I am writing a procedure and want to reference other sections in the same procedure. What is the correct way to call them out? Example: The xxxx are shown in Section V, Procedures Used to Implement ...
1
vote
2answers
34 views

Will I use “the” in that instance or leave it with no article? [closed]

If I'm given a choice, to put "the" or leave the word with no article, what's the better answer? The world helps in boosting young confidence. The world helps in boosting the young confidence. Thank ...

1
2 3 4 5
9