The Peptide CommonsEst. May 2024
Independent. We sell nothing and are affiliated with no manufacturer or pharmacy. Every moderation action is logged in public
Documentation · Doc review · continued

Coming back to: Recording a dissent on a document rather than suppressing it posts 31–48

This is a continuation of a long topic, addressed by post number rather than by page. Start at post 1.

EL
e.lokkenTL21 Feb 2025#31

Quietly grateful for the plain phrasing. Not every thread gets that.

23 likes 18mo
AA
an.adeyemiTL24 Feb 2025#32

A document that repeats a paragraph already maintained elsewhere should link instead, unless the reader would be mid-task and unable to follow a link.

It took me longer than it should have to see that.

10 likes 18mo
JN
j.nascimentoTL26 Feb 2025#33
CR
c.rasmussenTL29 Feb 2025 · edited#34
diluent_watch, post #8: Reviewing means reading it as somebody who needs the answer rather than as somebody checking it. Those two readings find different problems. Go to post

Taking post #32 at face value and following it one step further.

Recording a dissent is a question about a distribution, not about a value, and treating it as a value is what produces the confident wrong answers.

0 likes in reply to #8 18mo
HK
h.koodziejTL2Member12 Feb 2025#35

Reviewing your own nomination is fine and is not sufficient. Somebody else has to read it for the process to mean anything.

16 likes 17mo
EM
e.mwangiTL214 Feb 2025#36

Where the review finds the content is right but the framing overstates it, that is the most valuable catch available at this stage.

6 likes 17mo
ES
e.silvaTL217 Feb 2025#37

Where content is lifted from a topic, attribution should be in the document rather than only in the review thread.

Filing this under things that are true until someone shows me otherwise.

0 likes 17mo
TD
t.demirTL220 Feb 2025#38
ca.vermeulen, post #5: Agreed on all of that, and I have nothing to add to it. Go to post

This follows post #35 rather than contradicting it.

Check the links. Promotion frequently breaks a cross-reference because the source topic now points at the document rather than the reverse.

I would rather be precise about what I do not know than vague about what I do.

32 likes in reply to #5 17mo
NB
n.bridgewaterTL2Member22 Feb 2025#39
f.pires, post #30: Everything in post #28 holds. The case it does not cover is the one I have. A review date is a commitment rather than a formality, and a shorter cycle for a fast-moving subject is the whole point of setting it deliberately. Go to post

Post #35 describes the usual case. This is about the unusual one.

Second maintainers matter. A single maintainer is a single point of failure and every document here that went stale had one.

If anyone has run this properly I would rather read that than my own guess.

0 likes in reply to #30 17mo
NL
ne.laurentTL225 Feb 2025#40
MN
ma.nascimentoTL227 Feb 2025 · edited#41

Confirming post #39 from a second method, which matters more than confirming it from a second person.

Recording a dissent would be much easier to settle if anyone reported the denominator. Almost nobody reports the denominator.

0 likes 17mo
LP
l.parkinsonTL2Member2 Mar 2025#42

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.

I have changed my mind on this once already, so take it as current rather than settled.

4 likes 17mo
NH
n.hartmannTL24 Mar 2025#43
journalclub_wren, post #15: Where I part company with post #14, and it is a narrow parting. Where the review finds the content is right but the framing overstates it, that is the most valuable catch available at this stage. Go to post

Approving a document you have not read is worse than not responding, and it happens because approval feels supportive.

13 likes in reply to #15 17mo
VS
vial_slopeTL3Regular7 Mar 2025#44

Post #42 describes the usual case. This is about the unusual one.

Nothing in a maintained document is medical advice and the review should confirm the page says so where it matters rather than only in a footer.

I looked this up rather than remembered it, which is the right order.

27 likes 17mo
VM
v.malinowskiTL210 Mar 2025#45

Post #44 is the version of this I will quote in future. One addition.

An update on my earlier Recording a dissent post: the pattern held for another six weeks and then stopped, which I did not predict and cannot explain.

0 likes 17mo
N
NLoughranTL3Regular12 Mar 2025#46

Where I part company with post #42, and it is a narrow parting.

Point three stops most nominations. A document without a maintainer becomes wrong quietly, and that is the failure mode the criterion exists to prevent.

On reflection I would soften that slightly.

2 likes 17mo
KK
k.karlsenTL215 Mar 2025#47
I
IMainwaringTL3Regular17 Mar 2025#48

A document that repeats a paragraph already maintained elsewhere should link instead, unless the reader would be mid-task and unable to follow a link.

20 likes 16mo

Suggested topics

TopicParticipantsRepliesViewsActivity
Follow-up: Review cadence: how often is a page actually re-checked?
The question in the title: Review cadence: how often is a page actually re-checked? I will give what I have already checked below so nobody repeats it. I would like to know what people here actually do about…
TICLJI 2 64k 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…
NOBAIHN+3 7 13k 2.1y
Review cadence: how often is a page actually re-checked?
Asking directly, because I could not find a straight answer: Review cadence: how often is a page actually re-checked? I would like to know what people here actually do about review cadence, as distinct from…
RHPTATJSS+20 24 20k 15mo
Promotion criteria, and the one that stops most nominations — the long version
On the subject in the title: Promotion criteria, and the one that stops most nominations — the long version Working notes rather than a conclusion. A narrow question about Promotion criteria, deliberately…
FPJHCBKFAP+130 143 7.2k 6mo
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…
OFLOPMDBEV+46 51 11k 20h

Related topics — sharing the tags promoted to docs, review date, wiki post

TopicParticipantsRepliesViewsActivity
Merging two pages that cover the same ground — the long version
On the subject in the title: Merging two pages that cover the same ground — the long version Working notes rather than a conclusion. Bringing the figures rather than the impression, since a process question…
RHGTAJPRRM+5 9 209 20mo
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…
OFLOPMDBEV+46 51 11k 20h
[2026 update] Citation sweep results: how many references did not say what was claimed
Citation sweep results: how many references did not say what was claimed Writing it up because I had to work it out twice and would rather nobody else did. What changes if the standard account of Citation…
ATPPMVNGMO+41 45 47k 12mo
Splitting an overlong document into two
Posting this under the heading it deserves: Splitting an overlong document into two Everything below is what sits behind that. Trying to work out what would count as evidence on splitting an overlong…
CTHCAFNSA+30 34 6.2k 1d
About the Feature requests category
Requests for platform and documentation features, with the reasoning that justifies them. This post is a community wiki: any member at trust level 3 or above can edit it, and every edit is recorded with its…
TVJMFLAWPP 4 28k 9mo