Questions tagged [technical-writing]

Technical writing refers to writing on programming and technical-related topics.

Filter by
Sorted by
Tagged with
13 votes
5 answers

Idea for a physics–computer science joint curriculum and textbook [closed]

I want to write (and have starting outlining) a physics textbook which assumes its reader is a competent computer programmer. Normal physics textbooks teach physical formulas and give problems that ...
Ami's user avatar
  • 2,055
5 votes
1 answer

How does one write a book on a new framework? [closed]

How are authors able to write a book on a framework that is just released? A framework like spring is updated, and a book is released in the next day. Is this typically by people who are direct ...
monksy's user avatar
  • 639
4 votes
1 answer

JIRA Ticket Best Practices: How to write a good JIRA ticket [closed]

We "use" JIRA as our ticketing system, but "use" is a real stretch. We have no standards, no templates, no "best practices" documentation for writing a proper JIRA ticket. So I'm spearheading the ...
herpylderp's user avatar
  • 2,027
3 votes
3 answers

What is a good rule of thumb to do technical writing that doesn't confuse people

Sometimes I'm such a nerd that not even nerds understand me, or rather, sometimes I cannot put stuff in understandable and simple-enough terms... and sometimes I can but cannot really tell until after....
dukeofgaming's user avatar
3 votes
2 answers

Is there a standard way to refer to items inside a menu when writing documentation?

At several times in the past while writing software documentation -- including user manuals, user stories, bug reports, test cases, and emails to users/colleagues -- I've needed to be able to refer to ...
user avatar
2 votes
3 answers

Who should write the Technical Design Document? The BA or the Developer? [closed]

I work as a Snr. BA in a large Manufacturing company and I've just implemented a new Requirements Management Process. We have a large range of internal developers who in the past have never been ...
Dazzar's user avatar
  • 39
2 votes
4 answers

How do I write, review and coach better English language in documentation?

My job regularly involves writing and reviewing (in the form of pull requests) English prose in the documentation for our internal system, which solely faces other developers, in a strongly American ...
Oli's user avatar
  • 525
2 votes
1 answer

Formulate release notes consistently

In my project, I came across understanding that writing release notes is both helpful and necessary. However, it is not required by my management and I keep these files virtually to myself. You could ...
Pavlo Dyban's user avatar
1 vote
1 answer

Given-when-then template for docstrings

Tests can be very nicely written down using the given-when-then style. Are there similar styles / templates for describing methods and classes in docstrings? To clarify: There are many sites which ...
gebbissimo's user avatar
-2 votes
1 answer

An expression in the first line of the control flow statement

Is there a term or some short wording to refer to an expression in the "first" line of the control flow statement? func() { if (a == b) { var = 1 + 1 return True } else { var ...
john c. j.'s user avatar