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

Follow-up: Requesting a page: what makes a good request

Solved
Solved by s.leclerc in post #4
The commonest reason a good request stalls is that nobody converted it into a draft. A rough draft attracts editors; a request does not.

Jump to the accepted answer →

JW
journalclub_wrenTL3Regular7 Feb 2025#1

On the subject in the title: Requesting a page: what makes a good request Working notes rather than a conclusion.

Trying to work out what would count as evidence on Requesting a page, before collecting any. This is the part I usually skip and it is the part that makes the rest useful.

If two explanations predict the same observation, observing it does not help. So: what observation would separate them?

48 likes 18mo
C
chromatogramTL4Analytical chemist14 Feb 2025#2

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.

I would be glad to be shown a cleaner way of putting this.

0 likes 17mo
MB
m.brobergTL218 Feb 2025#3

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

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.

2 likes 17mo
SL
s.leclercTL4 Moderator Solution22 Feb 2025#4
journalclub_wren, post #1: On the subject in the title: Requesting a page: what makes a good request Working notes rather than a conclusion. Trying to work out what would count as evidence on Requesting a page, before collecting any. This is the part I usually skip and it is the part that makes the rest useful. If two explanations predict the same observation,… Go to post

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

8 likes in reply to #1 17mo
RE
r.ekstromTL226 Feb 2025#5
TH
TL4_HalvorsenTL4Leader · Journal club1 Mar 2025#6

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

0 likes 17mo
TD
t.dumitruTL25 Mar 2025#7
r.ekstrom, post #5: Scope the request narrowly. A page about one thing gets written and stays current; a page about a field does not. Go to post

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

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.

That is one dataset and I would not build a rule on it.

4 likes in reply to #5 17mo
EF
endo_fellow_rkTL3Endocrinology fellow8 Mar 2025#8
t.dumitru, post #7: Post #6 is the version of this I will quote in future. One addition. 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. That is one dataset… Go to post

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

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

Worth reading the earlier posts in this thread before acting on mine.

12 likes in reply to #7 17mo
TN
t.ndiayeTL211 Mar 2025#9

Narrowing post #6, because the general version has more than one answer.

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

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

0 likes 17mo
AF
a.friskTL214 Mar 2025#10

Saving this. It is the version I will quote when the question comes round again.

1 like 16mo
FE
footnote_entryTL3Regular17 Mar 2025#11
t.ndiaye, post #9: Narrowing post #6, because the general version has more than one answer. A document with no maintainer becomes wrong quietly, which is worse than not existing, because it carries the authority of a maintained page. I would be interested in a counterexample if anyone has one. Go to post

Everything in post #7 holds. The case it does not cover is the one I have.

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

0 likes in reply to #9 16mo
MO
m.oyelaranTL220 Mar 2025#12

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

21 likes 16mo
K
KStephanopoulosTL3Regular23 Mar 2025#13

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

Stating my assumptions rather than smuggling them in.

6 likes 16mo
AK
ar.kravchenkoTL226 Mar 2025#14

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

One case, stated as one case.

1 like 16mo
EM
endpoint_marginTL2Member28 Mar 2025#15
ar.kravchenko, post #14: Where a request is for a translation or a regional version, the maintenance burden doubles and the proposal should say who carries it. One case, stated as one case. Go to post

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

30 likes in reply to #14 16mo
SV
s.vogelTL231 Mar 2025#16

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 right answer here may simply be that it has not been measured.

15 likes 16mo
BP
bench_peakTL3Regular3 Apr 2025 · edited#17

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.

Anyone with a larger sample, please post it.

3 likes 16mo
RC
r.coelhoTL25 Apr 2025#18

This follows post #16 rather than contradicting it.

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 16mo
O
OTeixeiraTL3Regular8 Apr 2025#19

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

The variance between people here is larger than the effect being discussed.

0 likes 16mo
SO
s.oyelaranTL211 Apr 2025#20
RB
r.bakkenTL213 Apr 2025#21

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 is the honest state of it as of this week.

28 likes 15mo
NR
n.rowntreeTL3Regular16 Apr 2025#22
ar.kravchenko, post #14: Where a request is for a translation or a regional version, the maintenance burden doubles and the proposal should say who carries it. One case, stated as one case. Go to post

Nothing to add on the substance. Thank you for taking the question at face value.

0 likes in reply to #14 15mo
KK
k.kuuselaTL218 Apr 2025#23

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.

2 likes 15mo
FE
footnote_entryTL3Regular21 Apr 2025#24

Format suggestions: if you think a maintained page could be clearer in its presentation (different section structure, different examples, added graphics) suggest the change.

It is the kind of thing that is obvious once and never again.

9 likes 15mo
HC
h.castellanosTL223 Apr 2025#25

Right, and stated more narrowly than I would have dared to state it.

0 likes 15mo
K
KStephanopoulosTL3Regular25 Apr 2025#26
ar.kravchenko, post #14: Where a request is for a translation or a regional version, the maintenance burden doubles and the proposal should say who carries it. One case, stated as one case. Go to post

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

Marking that as an opinion rather than a finding.

0 likes in reply to #14 15mo
TI
t.ibarraTL228 Apr 2025#27
I
IsaksenTL3Regular30 Apr 2025#28

Accessibility feedback: if you have trouble accessing or reading a maintained page (screen reader issues, contrast problems, small text) report it. Accessibility matters.

14 likes 15mo
IB
i.boatengTL22 May 2025#29
r.coelho, post #18: This follows post #16 rather than contradicting it. 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. Go to post

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.

0 likes in reply to #18 15mo
BW
bac_waterTL2Regular5 May 2025#30

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

2 likes 15mo