3 ms·
It IS a good article, but the audience of the article is fairly specific yet left unspecified. As a general principal in technical writing it is advisable to s
by SubiculumCode 5y ago
It IS a good article, but the audience of the article is fairly specific yet left unspecified.
As a general principal in technical writing it is advisable to start with a "why you should care" statement because this naturally informs the reader about the context.
- wheelinsupial 5y agoIs the second section “when would I use this” sufficient to provide a “why you should care statement”? Or is there a more common way to call this out in technical writing? Perhaps an “intended audience” or “necessary prerequisites”?
- SubiculumCode 5y agoI mean there is nothing "wrong" with starting at the 2nd paragraph (and that was was just for the more limited Laplace version of Poisson's), its just not generally the most effective writing style. Yes, there is some subjectivity here, but writing is hard, and it is only through criticism that we learn to be better technical writers. The first paragraph of the conclusion would have better served as the Introductory remark: "Poisson's equation comes up in many domains. Once you know how to recognize it and solve it, you will be capable of simulating a very wide range of physical phenomena." That is a great sentence. I'm interested now, and I know its context.
- wheelinsupial 5y ago> it is only through criticism that we learn to be better technical writers. Hence the line of questioning. Thanks for the response!