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 · Wiki requests · continued

Requesting a page: what makes a good request — what changed since posts 91–120

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

B
BirkelandTL3Regular12 Oct 2024#91

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

Name a willing maintainer in the request. Point three of the criteria stops more nominations than the other three combined.

If the premise is wrong, everything after it is decoration.

2 likes 22mo
VR
v.rautioTL212 Oct 2024#92
s.silva, post #71: Where a request is for a translation or a regional version, the maintenance burden doubles and the proposal should say who carries it. Go to post

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

The strongest case for a new document is a question that recurs and has a good answer buried in a reply. That is the promotion criterion as written.

That has held every time I have looked, which is not the same as always.

0 likes in reply to #71 22mo
CT
cannula_traceTL3Regular12 Oct 2024#93

Useful. I have added it to my own notes with the date on it.

29 likes 22mo
GA
g.amankwahTL212 Oct 2024#94

A request is more likely to succeed with a proposed outline attached. "Somebody should write about X" rarely moves; a structure and two sections does.

14 likes 22mo
OF
outline_firstTL3Wiki editor12 Oct 2024#95
sleep_log, post #11: A request is more likely to succeed with a proposed outline attached. "Somebody should write about X" rarely moves; a structure and two sections does. I am describing what is, rather than arguing for what should be. Go to post

Post #94 put the caveat in the right place and I want to underline it.

Name a willing maintainer in the request. Point three of the criteria stops more nominations than the other three combined.

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

5 likes in reply to #11 22mo
CC
c.castellanosTL212 Oct 2024#96
b.okonkwo, post #85: Requests for a page summarising a supplier are declined, because that is what the vendor documentation set is for and it has its own standards. It is worth checking rather than assuming, which costs nothing. Go to post

Review cadence should be part of the proposal. A page about a fast-moving area needs a shorter cycle and somebody willing to honour it.

0 likes in reply to #85 22mo
NE
n.ekstromTL2Regular12 Oct 2024#97

Requests for a page summarising a supplier are declined, because that is what the vendor documentation set is for and it has its own standards.

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

0 likes 22mo
SV
s.vukovicTL212 Oct 2024#98

The arithmetic in post #97 is right; the assumption feeding it is the part to check.

Correction requests: if you spot an error in a maintained page, note it here with the specific correction. The maintainer will review and update if justified.

The claim is narrower than it sounds, and deliberately so.

20 likes 22mo
SS
steady_stateTL3Regular12 Oct 2024#99

The strongest case for a new document is a question that recurs and has a good answer buried in a reply. That is the promotion criterion as written.

0 likes 22mo
NC
n.cabreraTL212 Oct 2024#100

A request that says what the page should not cover is unusually helpful, because scope creep is what kills these.

30 likes 22mo
SP
s.perrinTL212 Oct 2024#101

A page that would need to be rewritten every quarter is usually better as a topic with a good marked solution.

0 likes 22mo
GC
glossary_checkTL2Member12 Oct 2024#102

Translation suggestions: if a maintained page should exist in another language, suggesting it here helps the maintainers prioritise multilingual work.

The short version is the first sentence; the rest is why.

24 likes 22mo
SK
s.kravchenkoTL212 Oct 2024#103
v.bhattacharya, post #89: Format suggestions: if you think a maintained page could be clearer in its presentation (different section structure, different examples, added graphics) suggest the change. Go to post

Coming back to post #101, because the follow-up matters more than the original answer.

A document with no maintainer becomes wrong quietly, which is worse than not existing, because it carries the authority of a maintained page.

It is worth stating the boring hypothesis before the interesting one.

11 likes in reply to #89 22mo
CN
cohort_notesTL2Member12 Oct 2024#104
t.dumitru, post #67: The commonest reason a good request stalls is that nobody converted it into a draft. A rough draft attracts editors; a request does not. Go to post

Post #101 is right about the mechanism and I think understates the practical bit.

Where a request is for a translation or a regional version, the maintenance burden doubles and the proposal should say who carries it.

3 likes in reply to #67 22mo
HJ
h.jansenTL212 Oct 2024#105

On post #101 — agreed on the reasoning, with one qualification.

Say what would make the page wrong. A page whose failure conditions are stated is much easier to review honestly.

0 likes 22mo
G
GEldridgeTL3Regular12 Oct 2024#106

Suggesting content for a page: if you know a maintained page is missing something important, post a suggestion with specific content you think should be added.

33 likes 22mo
AK
an.kirchnerTL212 Oct 2024 · edited#107
cohort_notes, post #104: Post #101 is right about the mechanism and I think understates the practical bit. Where a request is for a translation or a regional version, the maintenance burden doubles and the proposal should say who carries it. Go to post

Scope the request narrowly. A page about one thing gets written and stays current; a page about a field does not.

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

17 likes in reply to #104 22mo
EF
erratum_fileTL3Regular12 Oct 2024#108

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

A calculator request and a document request are different things, and a calculator without a document explaining it is worse than neither.

Not the answer, but possibly the question that gets there.

7 likes 22mo
ON
o.nybergTL212 Oct 2024#109

Post #105 and I disagree about the size of the effect, not about the direction.

What I want from this Requesting a page thread is the list of things that would need to be true for the claim to hold. If we can write that list, we can check it.

1 like 22mo
M
MakinenTL2Member12 Oct 2024#110
n.ekstrom, post #97: Requests for a page summarising a supplier are declined, because that is what the vendor documentation set is for and it has its own standards. That holds for the case as described. Change the assumptions and it may not. Go to post

Acknowledging rather than arguing. The reasoning holds as far as I can follow it.

0 likes in reply to #97 22mo
NC
n.cabreraTL212 Oct 2024#111

Reading rather than answering, but this is the post I would point somebody at.

8 likes 21mo
SS
steady_stateTL3Regular12 Oct 2024#112
b.teixeira, post #3: Thank you for the correction. I would rather find out here than later. Go to post

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

Scope creep: if you think a page is attempting too much and should be split into multiple pages, that is a reasonable suggestion.

20 likes in reply to #3 21mo
BK
b.kowalskiTL212 Oct 2024#113
r.novak, post #28: Flag a page that has drifted: if you notice a maintained page has information that is outdated (dates that have passed, regulatory changes, new evidence) post a flag so the maintainers see it. Go to post

Request a new maintained page: if a question recurs, has a good marked solution, and contains a worked example, it is a candidate for promotion to a maintained documentation page. Post your nomination in this subcategory with a link to the topic.

This is the sort of thing the wiki should carry and currently does not.

0 likes in reply to #28 21mo
JW
journalclub_wrenTL3Regular13 Oct 2024 · edited#114

Two claims get bundled together under Requesting a page and they need separating. The descriptive one — this is what was observed — is usually well supported. The causal one — this is why — usually is not.

Almost every disagreement in threads like this one dissolves once you say which of the two you are making.

0 likes 21mo
SO
se.okaforTL213 Oct 2024#115

Link the topics that prompted the request. The discussion is the evidence that the question recurs.

I would want to see it done twice before believing it once.

0 likes 21mo
OF
outline_firstTL3Wiki editor13 Oct 2024#116

Authority and authorship: if you think a maintained page needs input from someone with specific expertise (a clinician, an analytical chemist) suggest who might contribute.

A partial answer, offered because a partial answer beats none.

0 likes 21mo
SV
s.vukovicTL213 Oct 2024#117
e.roos, post #41: Review cadence should be part of the proposal. A page about a fast-moving area needs a shorter cycle and somebody willing to honour it. This is the version I would want a new member to read first. Go to post

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

Flag a page that has drifted: if you notice a maintained page has information that is outdated (dates that have passed, regulatory changes, new evidence) post a flag so the maintainers see it.

Posted with less confidence than the sentence structure implies.

4 likes in reply to #41 21mo
SB
sharps_binTL2Regular13 Oct 2024#118

The commonest reason a good request stalls is that nobody converted it into a draft. A rough draft attracts editors; a request does not.

I would put a moderate confidence on that and no more.

2 likes 21mo
VR
v.rautioTL213 Oct 2024#119

This follows post #116 rather than contradicting it.

Objections to a request belong in the open, and a request that survives an objection is a stronger page for it.

The uncertainty is in the assumption, not in the calculation.

0 likes 21mo
B
BirkelandTL3Regular13 Oct 2024#120

If a request is declined, the reasoning is written down, and it is worth reading because it usually describes a better version of the same idea.

I have said this before in a thread nobody could find, so it is worth repeating.

2 likes 21mo