Review: a draft on reconstitution arithmetic, with objections
Answering the question post #34 raises rather than the one it answers.
Check the arithmetic in every worked example by hand. A wrong worked example is worse than no example and survives longer.
Narrowing post #43, because the general version has more than one answer.
Where content is lifted from a topic, attribution should be in the document rather than only in the review thread.
Second this, and I would have said it less carefully.
On post #84 — agreed on the reasoning, with one qualification.
The most useful review comment names a sentence and says what is wrong with it. General approval and general concern are both hard to act on.
Post #113 is right about the mechanism and I think understates the practical bit.
The four criteria are that the question recurs, that the content is correct and sourced or labelled as community practice, that somebody will be named as maintainer with a review date, and that no unresolved substantive objection stands.
I have changed my mind on this once already, so take it as current rather than settled.
Quietly grateful for the plain phrasing. Not every thread gets that.
Read the full topic (130 posts)
This topic was referenced in
- Review: a draft on reconstitution arithmetic, with objections — what changed sinceDocumentation › Doc review · 50 replies
Suggested topics
| Topic | Participants | Replies | Views | Activity |
|---|---|---|---|---|
|
Review: a draft on reconstitution arithmetic, with objections — one year on
Review: a draft on reconstitution arithmetic, with objections — one year on Writing it up because I had to work it out twice and would rather nobody else did. The question about draft on reconstitution…
|
+46 | 51 | 11k | 20h |
|
A promotion I argued against, and why I lost
Posting this under the heading it deserves: A promotion I argued against, and why I lost Everything below is what sits behind that. Two things I would like separated before anyone answers on promotion,…
|
+148 | 162 | 3.9k | 16mo |
|
Revisiting: Review: an evidence digest and the citation check that delayed it
Revisiting: Review: an evidence digest and the citation check that delayed it — setting out what I have, and where I think it stops being reliable. Proposing that evidence digest deserves a maintained page…
|
+54 | 58 | 8.2k | 5mo |
|
Promotion criteria, and the one that stops most nominations
Promotion criteria, and the one that stops most nominations — setting out what I have, and where I think it stops being reliable. Nomination for promotion into the documentation commons, with the criteria…
|
+135 | 146 | 17k | 19mo |
|
A promotion I argued against, and why I lost — a second dataset
A promotion I argued against, and why I lost — a second dataset Writing it up because I had to work it out twice and would rather nobody else did. Posting a small dataset on promotion. It is mine, it is…
|
+3 | 7 | 32k | 12h |
Related topics — sharing the tags wiki post, promoted to docs, citation check
| Topic | Participants | Replies | Views | Activity |
|---|---|---|---|---|
|
A revision dispute resolved on the topic rather than in the history
A revision dispute resolved on the topic rather than in the history Writing it up because I had to work it out twice and would rather nobody else did. Proposing that revision dispute resolved deserves a…
|
+10 | 15 | 40k | 16h |
|
Request declined, with reasoning
Request declined, with reasoning — setting out what I have, and where I think it stops being reliable. I would like to know what people here actually do about request declined, as distinct from what is…
|
+2 | 6 | 173 | 13mo |
|
A revision dispute resolved on the topic rather than in the history — a second dataset
On the subject in the title: A revision dispute resolved on the topic rather than in the history — a second dataset Working notes rather than a conclusion. Posting a small dataset on revision dispute…
|
+45 | 50 | 33k | 20mo |
|
Coming back to: Recording a dissent on a document rather than suppressing it
Posting this under the heading it deserves: Recording a dissent on a document rather than suppressing it Everything below is what sits behind that. Recording a dissent, and specifically the version of it that…
|
+43 | 47 | 11k | 16mo |
|
What happens when a maintainer goes quiet
The question in the title: What happens when a maintainer goes quiet I will give what I have already checked below so nobody repeats it. Nomination for promotion into the documentation commons, with the…
|
+3 | 7 | 13k | 2.1y |