Pharmacopedia:Problems repository: Difference between revisions

Line 1:

This page documents the '''Problems repository''' — the controlled vocabulary that medicines on this wiki are tagged with via the <code><problem ref="..."/></code> parser tag.

This page documents the '''Problems repository''', the controlled vocabulary that medicines on this wiki are tagged with via the <code><problem ref="..."/></code> parser tag.

It is sysop- and contributor-facing reference, kept alongside the live data at [[Special:Problems]] (browse) and [[Special:ManageProblems]] (sysop curation).

Line 5:

== What a Problem is ==

A '''Problem''' is anything a medicine is used '''for''' — a diagnosis, symptom, functional state, lab target, or any other pharmacological target. The category is deliberately broader than DSM-5/ICD-10 diagnoses because not everything a medicine is used for is a formal diagnosis: ''insomnia'', ''smoking cessation'', ''jet lag'', ''public speaking anxiety'', and ''recreational use'' are all valid Problems.

A '''Problem''' is anything a medicine is used '''for''', a diagnosis, symptom, functional state, lab target, or any other pharmacological target. The category is deliberately broader than DSM-5/ICD-10 diagnoses because not everything a medicine is used for is a formal diagnosis: ''insomnia'', ''smoking cessation'', ''jet lag'', ''public speaking anxiety'', and ''recreational use'' are all valid Problems.

== Problems ≠ Diagnoses ==

Line 27:

== Auto-approval ==

User submissions are '''auto-approved on submit'''. There is no pending queue. The reasoning: lowering friction matters more than gatekeeping at this stage. Sysops handle quality after the fact via [[Special:ManageProblems]] — merging duplicates, retiring spam or low-quality entries, fixing category assignments.

User submissions are '''auto-approved on submit'''. There is no pending queue. The reasoning: lowering friction matters more than gatekeeping at this stage. Sysops handle quality after the fact via [[Special:ManageProblems]], merging duplicates, retiring spam or low-quality entries, fixing category assignments.

== Curation operations (sysop only) ==

Line 33:

[[Special:ManageProblems]] supports:

* '''Edit''' — change a Problem's name, description, category, or aliases. Slug is immutable (other pages reference it).

* '''Edit''', change a Problem's name, description, category, or aliases. Slug is immutable (other pages reference it).

* '''Retire''' — soft-deletes a Problem. Existing <code><problem ref="..."/></code> tags referencing it will show "unknown ref" errors unless merged.

* '''Retire''', soft-deletes a Problem. Existing <code><problem ref="..."/></code> tags referencing it will show "unknown ref" errors unless merged.

* '''Retire and merge''' — retires the duplicate AND points its <code>p_merged_into</code> field at the canonical entry. The <code>ProblemTag</code> renderer follows merge chains up to 5 hops, so all existing references continue resolving to the canonical Problem. This is the preferred way to handle duplicates.

* '''Retire and merge''', retires the duplicate AND points its <code>p_merged_into</code> field at the canonical entry. The <code>ProblemTag</code> renderer follows merge chains up to 5 hops, so all existing references continue resolving to the canonical Problem. This is the preferred way to handle duplicates.

* '''Unretire''' — restores a previously-retired Problem.

* '''Unretire''', restores a previously-retired Problem.

* '''Create''' — manually add a Problem without going through the suggest flow.

* '''Create''', manually add a Problem without going through the suggest flow.

When in doubt, '''merge rather than retire'''. Merging preserves the slug's resolvability; bare retirement breaks references.

Line 78:

| <code>addiction</code> || AUD, OUD, CUD, smoking cessation, opioid maintenance

|-

| <code>functional</code> || RSD, HSP, misophonia, SPD — things that don't fit DSM cleanly

| <code>functional</code> || RSD, HSP, misophonia, SPD, things that don't fit DSM cleanly

|-

| <code>symptomatic</code> || Symptoms not yet rising to disorder level (low mood, anxiety, nausea, fatigue, itch, fever, agitation)

Line 89:

== Slug conventions ==

Slugs are lowercase, hyphenated, ASCII-only, with no leading/trailing hyphens (enforced by <code>ProblemStore::normalizeSlug</code>). They are derived from the Problem's canonical name on creation but become '''immutable''' afterward — renames go through the merge mechanism, not slug edits.

Slugs are lowercase, hyphenated, ASCII-only, with no leading/trailing hyphens (enforced by <code>ProblemStore::normalizeSlug</code>). They are derived from the Problem's canonical name on creation but become '''immutable''' afterward, renames go through the merge mechanism, not slug edits.

Examples:

Line 102:

== See also ==

* [[Special:Problems]] — browse the live repository

* [[Special:Problems]], browse the live repository

* [[Special:ManageProblems]] — sysop curation

* [[Special:ManageProblems]], sysop curation

* [[Special:SuggestProblem]] — propose a new Problem

* [[Special:SuggestProblem]], propose a new Problem

* [[Pharmacopedia:Citation needed]] — sitewide citation rule

* [[Pharmacopedia:Citation needed]], sitewide citation rule

[[Category:Pharmacopedia]]

[[Category:Documentation]]

MDElliottMD (talk | contribs)