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

Review: an evidence digest and the citation check that delayed it

DO
dr_okonkwoTL4 Moderator26 Mar 2026#1

On the subject in the title: Review: an evidence digest and the citation check that delayed it Working notes rather than a conclusion.

I was wrong about evidence digest in a thread last spring and I would like to correct it publicly rather than quietly.

The error was in the units, which changed the conclusion by an order of magnitude. Setting out the corrected version, and the way I now check for that class of mistake.

0 likes 4mo
FF
f.fenwickTL3Regular9 Apr 2026#2

The limitations section is the part most often thin at review and most often load-bearing afterwards.

1 like 4mo
SH
s.hartmannTL218 Apr 2026#3

Building on post #2 rather than restating it.

Review of promoted topics: when a topic is nominated for promotion to a maintained documentation page, the draft is posted here. Community review happens before promotion. Objections are welcome.

For what it is worth, the same held on the two occasions I checked.

6 likes 3mo
K
KForsbergTL2Member27 Apr 2026#4

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.

Adding it in case it saves somebody the afternoon it cost me.

17 likes 3mo
ON
o.nybergTL25 May 2026 · edited#5

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.

32 likes 3mo
MW
m.wanjalaTL1Member12 May 2026#6
o.nyberg, post #5: 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

Answering the question post #4 raises rather than the one it answers.

Where a review raises something the author disagrees with, recording the disagreement in the review thread is better than resolving it privately.

0 likes in reply to #5 3mo
SR
s.radichTL219 May 2026#7

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

Happy to be corrected if someone holds better data than mine.

3 likes 2mo
M
MakinenTL2Member26 May 2026#8

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

11 likes 2mo
FE
f.espinozaTL22 Jun 2026#9

Adding the measurement that post #6 says would settle it.

Check that each claim is sourced or explicitly labelled as community practice. Unmarked practice claims read as sourced ones.

I would be interested in a counterexample if anyone has one.

1 like 2mo
W
WoodhouseTL2Member9 Jun 2026#10
m.wanjala, post #6: Answering the question post #4 raises rather than the one it answers. Where a review raises something the author disagrees with, recording the disagreement in the review thread is better than resolving it privately. Go to post

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

Check the arithmetic in every worked example by hand. A wrong worked example is worse than no example and survives longer.

That holds for the case as described. Change the assumptions and it may not.

6 likes in reply to #6 2mo
MS
m.stephanopoulosTL3Regular15 Jun 2026#11
KForsberg, post #4: 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. Adding it in case it saves somebody the afternoon it cost me. Go to post

Ask what the page would look like if it were wrong. A document with no stated failure conditions is hard to review and harder to maintain.

It is one reading of the data and not the only reasonable one.

4 likes in reply to #4 1mo
BN
b.nwosuTL221 Jun 2026#12
o.nyberg, post #5: 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

Building on post #11 rather than restating it.

Review the scope as well as the content. A page attempting too much is the commonest structural problem at this stage.

0 likes in reply to #5 1mo
RG
r.girardTL227 Jun 2026#13
ZI
z.iyerTL23 Jul 2026#14

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.

12 likes 25d
Z
ZieglerTL3Regular9 Jul 2026 · edited#15
s.hartmann, post #3: Building on post #2 rather than restating it. Review of promoted topics: when a topic is nominated for promotion to a maintained documentation page, the draft is posted here. Community review happens before promotion. Objections are welcome. For what it is worth, the same held on the two occasions I checked. Go to post

Citation checking: if a maintained page cites a paper, the citation should match what the paper actually says. If you notice a mismatch, post it here.

Adding a source would improve this post and I do not have one to hand.

7 likes in reply to #3 19d
WM
w.moreauTL215 Jul 2026#16

Evidence synthesis requests: if you think a page should summarise the state of evidence on a question, and you think the information exists but is scattered, suggest how it could be brought together.

Not disagreeing with anyone above, just adding the bit I keep having to look up.

1 like 13d
BP
baseline_peakTL2Member21 Jul 2026#17

Answering the question post #15 raises rather than the one it answers.

Review date disputes: if a maintained page's review date is approaching and it has not been updated, post a note so the maintainers notice.

I have kept the units in throughout, for the obvious reason.

0 likes 7d
BJ
b.jansenTL226 Jul 2026#18

Adding thanks rather than a view. I do not have a view worth the space.

17 likes 2d

Suggested topics

TopicParticipantsRepliesViewsActivity
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…
TDRSGVZMD+135 146 17k 19mo
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
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…
JDZGVRSCV+43 47 11k 16mo
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,…
GPONDISHGF+148 162 3.9k 16mo
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

Related topics — sharing the tags citation check, review date, promoted to docs

TopicParticipantsRepliesViewsActivity
Revisiting: A page that has drifted out of date and needs a maintainer
Revisiting: A page that has drifted out of date and needs a maintainer Writing it up because I had to work it out twice and would rather nobody else did. Nominating something for promotion into the…
HSASAKITTM+112 119 8.8k 5mo
Pages past their review date, listed
Pages past their review date, listed Writing it up because I had to work it out twice and would rather nobody else did. Posting a small dataset on pages past. It is mine, it is uncontrolled, and the method is…
CLKKSHFF+26 30 6.4k 10mo
About the Wiki requests category
Request a new maintained page, or flag one that has drifted out of date. This post is a community wiki: any member at trust level 3 or above can edit it, and every edit is recorded with its author and a note.…
KOBTFCKLO+3 7 655 19mo
Request: a diff view for wiki revisions
Request: a diff view for wiki revisions — setting out what I have, and where I think it stops being reliable. I would like to know what people here actually do about diff view for wiki revisions, as distinct…
MHJCFKT+24 30 3.1k 19mo
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