: Q about verb tenses for technical writing This kind of thing comes up a lot in my engineering job. We're writing a document that is a Plan for something we'll be doing in the future. For

This kind of thing comes up a lot in my engineering job. We're writing a document that is a Plan for something we'll be doing in the future. For instance, a Test Plan that describes who will participate in the test, what will be tested, and how the results will be documented. For instance, "System developers will be required to transport their systems to the facility in Boulder, CO." It is true that in the future, the systems will go to that facility. But I think it's more correct to write it "System developers are required to transport their systems to the facility in Boulder, CO." My sense is that this way of writing it makes the sentence valid both now and in the future (the future here is at the time when the transport takes place), whereas, the first way of writing it is only valid now.

Is it correct that the 2nd way is better writing? If so, what is the general rule that I can cite? Is it "verb tense" or some other rule?

Load Full (1)

: Are there any free sites for testing beta 'book cover' designs? The LONG road to publishing a novel is nearing an end. But writing a novel is actually only the beginning; editing, formatting,

@Shelton455

Load Full 2 Comments

: There are several techniques: Have a narrator voice explicitly stating the relevant differences. Take everything for granted and hint changes indirectly (e.g.: if your aliens have seven fingers

@Shelton455

Load Full 0 Comments

: 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

@Shelton455

Load Full 2 Comments

: Is it a good idea to make the protagonist unlikable while making the supporting characters more likable? My protagonist is a very shitty person that makes bad decisions for the wrong reasons.

@Shelton455

Load Full 3 Comments

Login to post a comment!

1 Comments

Sorted by latest first Latest Oldest Best

@Radia543

In general for technical documents, I follow the convention that present tense is the simplest and most appropriate. Avoid future and conditional tenses. I also avoid phrases such as "should be" that are judgmental rather than factual.

In the particular examples in the question, "Developers are required" or "developers must" is present tense and direct. "Developers will be" is not as effective, because the future tense just leaves hanging the question of "when?"

Load Full (0)

Feed

: Q about verb tenses for technical writing This kind of thing comes up a lot in my engineering job. We're writing a document that is a Plan for something we'll be doing in the future. For

More posts by @Shelton455

: Are there any free sites for testing beta 'book cover' designs? The LONG road to publishing a novel is nearing an end. But writing a novel is actually only the beginning; editing, formatting,

: There are several techniques: Have a narrator voice explicitly stating the relevant differences. Take everything for granted and hint changes indirectly (e.g.: if your aliens have seven fingers

: 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

: Is it a good idea to make the protagonist unlikable while making the supporting characters more likable? My protagonist is a very shitty person that makes bad decisions for the wrong reasons.

Login to post a comment!

1 Comments

Back to top