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

Requesting a page: what makes a good request — what changed since

Closed
K
KTurkingtonTL3Regular8 Oct 2024#1

Posting this under the heading it deserves: Requesting a page: what makes a good request — what changed since Everything below is what sits behind that.

What changes if the standard account of Requesting a page is wrong? I ask because I have been treating it as settled and I noticed this week that I could not say why.

Working through the consequences rather than the evidence, since others here are better placed on the evidence.

48 likes 22mo
K
KStephanopoulosTL3Regular8 Oct 2024#2

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
BT
b.teixeiraTL28 Oct 2024#3

Thank you for the correction. I would rather find out here than later.

4 likes 22mo
EM
endpoint_marginTL2Member9 Oct 2024#4

Worth separating two things that post #2 runs together.

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.

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

12 likes 22mo
AK
a.kravchenkoTL29 Oct 2024#5
CI
citation_indexTL2Member9 Oct 2024#6
KStephanopoulos, post #2: 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. Go to post

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.

0 likes in reply to #2 22mo
MO
m.oyelaranTL29 Oct 2024 · edited#7

Picking up post #4: that is the part I would want checked first.

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.

Marking that as an opinion rather than a finding.

7 likes 22mo
G
GSwinburneTL1Member9 Oct 2024#8

On post #6 — 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.

That is what the documentation says. What happens in practice is usually close.

18 likes 22mo
GA
g.amankwahTL29 Oct 2024#9
citation_index, post #6: 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. Go to post

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

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

0 likes in reply to #6 22mo
CT
cannula_traceTL3Regular9 Oct 2024#10

I had written a reply contradicting post #6 and deleted it. Here is what survived.

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

Where I would look next, rather than where I would stop.

1 like 22mo
SL
sleep_logTL2Regular9 Oct 2024#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.

0 likes 22mo
JB
j.bhattacharyaTL29 Oct 2024#12

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.

29 likes 22mo
SC
s.chowdhuryTL3Regular9 Oct 2024#13
cannula_trace, post #10: I had written a reply contradicting post #6 and deleted it. Here is what survived. Scope creep: if you think a page is attempting too much and should be split into multiple pages, that is a reasonable suggestion. Where I would look next, rather than where I would stop. Go to post

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

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

Anyone with a larger sample, please post it.

15 likes in reply to #10 22mo
AI
an.ibarraTL29 Oct 2024#14

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.

I have seen it go both ways, which is why I hedge.

5 likes 22mo
FN
formulary_notesTL3Regular9 Oct 2024#15

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

0 likes 22mo
CA
c.amankwahTL29 Oct 2024 · edited#16
KStephanopoulos, post #2: 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. Go to post

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

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

0 likes in reply to #2 22mo
TH
TL4_HalvorsenTL4Leader · Journal club9 Oct 2024#17

Noted, and I have changed what I was going to do on the strength of it.

21 likes 22mo
CC
ch.correiaTL29 Oct 2024#18

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

That is all the detail I have. Someone else will have more.

9 likes 22mo
N
NorringtonTL3Regular9 Oct 2024#19

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

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

2 likes 22mo
GT
g.tammTL29 Oct 2024#20
formulary_notes, post #15: Name a willing maintainer in the request. Point three of the criteria stops more nominations than the other three combined. Go to post

Understood, and I withdraw the assumption I opened with.

0 likes in reply to #15 22mo
TS
t.steenkampTL2Member9 Oct 2024#21

Reading rather than contributing, but this is the most useful thread I have found on it.

26 likes 22mo
KA
k.adeyemiTL29 Oct 2024#22

Worth separating two things that post #19 runs together.

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

Adding it because I spent an afternoon working it out and nobody should have to twice.

0 likes 22mo
CE
crossover_entryTL3Regular9 Oct 2024 · edited#23

Post #22 answers the question as asked. The question underneath it is different.

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

Correct me on the arithmetic if it is wrong; I would rather know.

4 likes 22mo
AW
ai.wikstromTL210 Oct 2024#24
citation_index, post #6: 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. 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.

13 likes in reply to #6 22mo
L
LJankowiakTL3Regular10 Oct 2024#25

Picking up post #22: that is the part I would want checked first.

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 not lead a decision with this, but I would not ignore it either.

0 likes 22mo
AC
a.cardosoTL210 Oct 2024#26

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

Whatever the answer on Requesting a page turns out to be, the method for getting there is the same: state the assumption, do the arithmetic in public, invite the correction.

0 likes 22mo
OA
o.abrahamsenTL3Regular10 Oct 2024#27

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

7 likes 22mo
RN
r.novakTL210 Oct 2024#28
g.amankwah, post #9: Scope the request narrowly. A page about one thing gets written and stays current; a page about a field does not. It is the kind of thing that is obvious once and never again. Go to post

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.

18 likes in reply to #9 22mo
S
SHermansenTL2Member10 Oct 2024#29

Building on post #26 rather than restating it.

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.

13 likes 22mo
NR
n.ramosTL210 Oct 2024#30

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

27 likes 22mo