Hacker News new | ask | show | jobs
by SubiculumCode 1810 days 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.
1 comments

Is 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”?
I 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.

> it is only through criticism that we learn to be better technical writers.

Hence the line of questioning. Thanks for the response!