Posts tagged technical-writing
Should we use present tense or future tense when writing an article? I know this question will be off topic if I asked without example. So I will add an example: You should use a very clean fo...
I read many articles on-line, but cannot understand where to draw the line between expository and argumentative writing. According to many articles, expository writing presents information. Argumen...
I am in the middle of the painful process of buying a car. I am trying to do much of my legwork online before going into a dealership. One of the things I hate the most about purchasing a car is se...
when writing knowledge base articles to support software users - is it ok to reference the screenshots I am using with the term "Figure"? For example, using '(See figure 1)' in the body text when ...
At work we provide three types of technical document, aimed at different kinds of users : The Quick Start Guide. Single laminated sheet, illustrations and basic explanation. The handbook. A5 form...
For example, in Skype conversations you use emoticons. I might use (headbang) after a phrase to express frustration, or I can have a (facepalm) moment, or I can write a joke and add (rofl), etc. B...
Hello everyone! I want to know how to format text to something normal as depicted in the image. How can this be done quickly? Thank you for your time!
There is a lot of advice on how to be a tech writer for software without a tech background. (That is, skills such as understanding end-users, investigative reporting-type skills to probe experts, e...
I am writing the built-in help for a command line program. The exact name is irrelevant, so let's use foo as a placeholder. This utility can be called with some arguments (like foo -v) or without ...
In scientific papers (in my case it's usually in computer science) it seems to me that some techniques which help in explaining concepts and technology are not used that much. For example a metaph...
I would like to put the following code in an article that is written in AP Style: puts 'Hello, world!' How do I do this? If I were to put the code (C++, Ruby, whatever) in an article that was wr...
In the book What If?, the author usually write the unit as kilometer, atmosphere, megawatt instead of km, atm, MW. However he does use the symbols in the drawings: In one line both mm and millim...
I'm considering working in writing. I'd like to save myself some time in case I'm not up for the job. How do I go about evaluating myself as a professional writer? I was going to ask for a peer ...
For a new guidebook project (freelancing in IT) I wonder at which point I should evaluate the idea. I see these possibilities: Create a website with a newsletter subscription form and see if peop...
I have been searching for a Runbook / Operations Guide example and can't seem to find a useful one for my company. The current runbook they handed me contains use cases and requirements, which I k...
When writing a legal document, what is the proper way to replace and/or in a list with more than two terms to remove ambiguity? For example, if I just have two terms: deliver apples and/or ora...
So a little while ago someone said that I'll never be able to write on a native level because I wasn't born in the UK or America. I did, however, go to elementary school in the US at the ages of 5-...
I have to further explain my intent here. I'm writing down some procedures in operating manuals and servicing manuals. I mostly use numbered lists and sometimes just bulleted lists. Recently I star...
I want to rewrite my sentence in technical writing style. Could you help me rewrite my sentence? Thank you in advance The proposed methods has 4 variables need to update in a optimization proce...
My question is similar to this one, but with (hopefully) a clearly defined use case: sharing and reviewing basic tech docs with a minimal, intuitive GUI. I'm producing technical documents using MS...
I currently have the prospect of writing a considerable amount of technical documentation (describing interactions with an extremely complex online service). I consider myself a reasonably proficie...
I am writing my thesis. and I need to know the correct way of putting the reference. for example: this is a sentence taken from someone [2]. this is a sentence taken from someone[2]. ...
Excuse me if I am on the wrong StackExchange site. I write about Physics in English and typeset that with LaTeX. So I have a variable c, and there are two of them in the same expression. I want to...
I volunteer as an editor for the Mozilla Developer Network (MDN), an organization that creates free open source software such as the Firefox browser. MDN has a large number of technical topics awai...
I have been asked to write a report on the company I am working at during a placement from University (I am on an engineering programme). There was not much guidance given on what the content of th...
The oxford comma is the second comma in the sentence I like the colors red, white, and blue. Every grammar textbook I've ever seen, as well as the major style guides, feels that this is "proper" de...
In the text, I have, e.g. "...a major role to play in role-playing (Smith et al., 1990)." But can I use the same abbreviation in the bibliography? Smith, K. et al. 1990. Playing major ro...
What is Content Testing? Are there content testing tools available, or is content simply tested manually for quality?
We are working on a technical documentation project which includes the rewriting, modernization, restructuring, enrichment of the content. I'm doing the content rewriting and translation parts of t...
I am writing an an article to share knowledge, not novel. Usually, when you change the current topic, at the beginning of the new paragraph you would like to use some transition words such as Addit...
In writing procedural documentation, I have the choice of writing the complete step-by-step instructions with references to an appendix of illustrations, For instance: 1. Do task 1 (see Fig. 1) ...
I'm getting into non-fiction technical writing (a blog, but potentially ebook or otherwise). Often the best technical advice come from dissecting and synthesising good and bad examples from the ind...
I must write a book for the university and I am looking for software. The style that I want is like the books of O'Reilly, Apress or Packt. I need: Insert a table of contents (automatic). Divide...
I have been asked to write various technical and non-technical articles about computer usage, Windows usage (perhaps some Mac and *nix as well if they let me), Windows repair, and various other tec...
Software products evolve more rapidly each day. Technical documentation for those products must also follow their evolution. One of the biggest challenges is to maintain screenshots when the graphi...
Whilst writing technical documentation, there is commonly a section on troubleshooting or frequently asked questions. I know a FAQ should be real questions - not ones the publisher thinks might b...
This came up when I was writing my thesis: Usually it is recommended that when writing a thesis, one sticks to passive voice and use sentences that read like "The study showed the effect that blah...
I'm about to write a technical description for an industrial process. The description will follow logical blocks, or blocks from the PFD of the process. This a sales document aimed at engineers. Be...
Background: Im working on a rather long instructional book, and have just started trying to use LaTeX. The book doesn't have any scientific notation in it, and most of the diagrams I made in other ...
To my knowledge step-by-step tutorials should have the form of a ladder, where you describe how to get to a place step by step– accomplishing a single task at the end. Is it possible to accomplish ...
So I feel I'm a pretty good programmer in my area of expertise. Whats the process for writing a book about my niche and getting it published?
I'm writing a group paper and I was wondering whether there's a correct way to list multiple authors at the top of the first page in MLA format. Normally the header would look something like: My N...
At least in the US, "will" has replaced "shall" in most every context, with the notable exception of the "legal shall". Shall is used instead of will in legal documents to indicate a sense of oblig...
I found some examples of good and poor example of executive summaries here. Everything seems fine but in one of them, they included this sentence - "All calculations can be found in the appendi...
I'm writing an academic paper on ethics in robotics. I have a previous paper that I wrote and would like to use material from it. If I use the material from this paper, that I wrote, do I need to...
I am new in the working world and I happen to be given a lot of tasks related with creating report. Later on I heard people give me comments that my sentence structure and my word choices are not ...
Although I'm pretty confident in my English, I'm not a native English speaker. I need to write a short introduction for a symposium; I'd like to know if you think this paragraph feels like 'natural...
I've recently composed a blog post about World of Warcraft Authenticators and would love for some feedback as per the quality of writing. Obviously no matter how many times I read it there's no su...
In technical writings are good established standards for formatting literature references. But that doesn't work this well for URLs. How should these references be formatted?
- ← Previous
- 1
- 2
- 3
- 4
- 5
- Next →