Philosopher’s Glossary
Standard Work Addition Process
Standard Work Addition Process
Use this runbook whenever adding or correcting philosophy works. A work is not complete until the work table row, work page row, WordPress child page, profile card, Works of Philosophy hub, and affected listing pages all agree.
1. Decide Whether It Belongs
- Add only directly authored or securely attributed works.
- Confirm the work from source evidence before creating a SQL row or child page. Use Other Voices sources, primary-text catalogues, library records, scholarly bibliographies, and reliable editions.
- Do not create work pages for spurious, disputed, fragmentary, testimonia, commentary-only, or merely associated texts unless explicitly approved.
- Record disputed, rejected, uncertain, or merely associated material in evidence notes, not as live work pages.
2. Required Works Master Fields
- Title: canonical English display title used for the card and page title.
- Original Title: original-language title or most standard transliteration. Leave distinct from Title only when it carries useful information.
- Alternate Titles: semicolon-separated alternate English titles, abbreviations, Latin titles, common short names, or transliteration variants.
- Author: exact philosopher display name and linked on the work page.
- Year Written / Year Published: use the best securely supported integer year. If only a range is known, use the most defensible cataloguing year and explain the range in the work page or evidence notes.
- Language: original composition language where known.
- Philosophical Tradition: tradition, school, movement, or intellectual setting, not a loose marketing label.
- Primary Discipline / Secondary Discipline: core-area taxonomy values used for work-page metadata and filtering. Do not show these as duplicate metadata lines on profile work cards.
- Core Thesis: one direct sentence beginning with a strong verb such as argues, claims, develops, attacks, defends, distinguishes, grounds, or redefines.
- Key Concepts, Methodology, Structure, Notable Arguments, Influence On, Influenced By, Historical Significance, Modern Relevance: fill with distinct, evidence-backed content. Do not repeat the thesis in multiple fields.
- HasFullText: set to 1 only when a public full-text section has been added to the work page and verified.
3. Table Write Order
- Snapshot current rows from Philosophy.[Philosophy Works Master] and Philosophy.[Philosophy Works Pages Master] for the philosopher.
- Insert or update the Philosophy Works Master row first, keyed by philosopher and canonical Title.
- Create or update the WordPress child page under the philosopher page.
- Insert or update the Philosophy Works Pages Master row with WorkMasterId, WpPageId, Title, Slug, Url, RelativeUrl, and HasFullText.
- Only set HasFullText = 1 in both works tables after the full-text section exists on the public work page and returns 200.
4. Work Page Rules
- Create or update one child page per approved work under the philosopher profile.
- Use the approved work-page layout and keep author, country, disciplines, work date/date note, attribution caveat, and parent page correct.
- Do not upload work-page media unless the work evidence requires it and the artifact states the reason. Reuse existing WordPress media by filename stem and SQL local path before any upload.
- Visible captions must identify the manuscript, edition, title page, artwork, place, or artifact. Do not use provider-only captions or file/source housekeeping text.
- Each public work page must link back to the philosopher profile and must not expose source boilerplate, duplicate cards, or stale metadata classes.
5. Full Text Rules
- Set HasFullText = 1 only when verified public full text is actually added to the work page.
- Set HasFullText = 0 for metadata-only, fragmentary, copyright-protected, unverified, or source-citation-only entries.
- Do not show a full-text badge, full-text styling, or full-text section unless HasFullText = 1.
- When full text is added, remove source boilerplate and preserve only the text appropriate for public reading.
6. Profile Work Card Rules
- Cards are ordered by Year Written, then Year Published, then Title.
- Each card shows the linked work title, visible year/date, optional Full text available label, and the core thesis.
- Full-text cards use the approved alternate background color.
- Do not repeat the title below the title link.
- Do not show Original Title, Primary Discipline, or Secondary Discipline as a bold metadata line on the card.
- Do not use bubble tags on work cards.
- If the philosopher has no linked works, show only: No major works are linked yet.
7. Hub And Listing Updates
- Update the profile work cards after SQL rows and child pages are valid.
- Update the Works of Philosophy hub so each live work appears exactly once and no stale work rows remain.
- Patch or republish affected philosopher cards and taxonomy/listing pages only where the current philosopher appears.
- Do not rebuild unrelated pages, unrelated hubs, or unrelated media during a works-only correction.
8. Validation Checklist
- SQL: no orphan works, no orphan work pages, expected HasFullText values, unique work-page URL/slug, correct WorkMasterId linkage, and no duplicate source/media rows.
- Work pages: public URL returns 200, child page parent is correct, author/country/discipline links work, date/date note is visible, attribution caveat appears where needed, and full-text sections appear only where HasFullText is 1.
- Media: no duplicate work-page attachments, no source-only captions, no stale media from failed runs, and every used attachment is referenced by the intended live page or SQL row.
- Profile cards: title appears once, date is visible, no primary/secondary card fields, no bubble tags, full-text badge appears only when expected, and card ordering is correct.
- Works hub: work appears once, links to the child page, full-text styling and label appear only when expected, and stale metadata classes are absent.
- Public text: no Gutenberg start/end markers, archive boilerplate, or provider housekeeping appears in the visible full text.
9. Final Report For Work Adds
- List WorkMasterId, work page ID, work URL, and HasFullText value for each work.
- State which profile, work pages, Works of Philosophy, and listing pages were published or patched.
- Report public 200 checks and card/content checks.
- Name any remaining uncertain attribution, dating, source, or full-text gaps.