Template:TissueDB Structures/doc

This template creates gateway pages for anatomical structures in the TissueDB namespace. A structure page serves as a finding page — a navigational hub that lists the constituent tissues of an anatomical system. Structure pages contain no instructions, materials, simulator listings, or pedagogical content.

Philosophy: "The simplest table imaginable. No one spends any time on a structures page." This template enforces that principle by providing only essential parameters and preventing injection of prohibited content (instructions, materials, antiskills, fidelity ratings, version history).

This template generates a TissueDB structure page with the following components:

• A clinical lead paragraph (2–4 sentences, metric-first)
• A Component Tissues table with mandatory links to TissueDB/Tissues/ pages
• Optional collapsed sections for quick reference (At a Glance) and deeper context (Background)
• Mandatory metadata templates and category links

The template is minimal by design. Required parameters are limited to: page title, lead description, component tissues table, and page metadata (keywords and description). Optional sections expand the page only if content is provided.

This template is used on pages in the TissueDB/Structures/ namespace only.

Example page titles:

• TissueDB/Structures/Abdominal_Wall
• TissueDB/Structures/Peritoneum
• TissueDB/Structures/Heart

Pages must follow the naming convention (generic, clinically descriptive names; no brand, lab, or product names).

Parameter	Required?	Type	Description	Example
page_title	Yes	String	Page namespace (must start with TissueDB/Structures/). Used for validation only; not displayed on page.	TissueDB/Structures/Abdominal_Wall
lead_description	Yes	Prose (2–4 sentences)	Clinical context introduction. Must use metric-first format for all measurements: "X cm (Y in)", "X kg (Y lbs)". Establishes why the structure matters for simulation and surgery.	"The abdominal wall is a layered structure comprising skin, fascia, and abdominal muscles (45–50 cm width in adults). It provides structural support, protects abdominal organs, and is critical to understand for abdominal surgical procedures."
component_tissues_table	Yes	WikiTable markup	Full wikitable with exactly 4 columns: Tissue, Layer, Key Properties, TissueDB Page. See Component Tissues Table Schema section below. Every tissue entry must link to a TissueDB/Tissues/ page.	See Examples section.
at_a_glance_section	Optional	String	Quick reference content. Rendered in a collapsed "details" container. Examples: "3 primary tissue layers; used in 5 simulators; critical for abdominal access." Leave empty or omit if not needed.	Layers: 3 primary tissue types. Used in: 5+ simulators. Clinical relevance: Critical for surgical access.
background_section	Optional	String with subsection headers	Collapsed parent container with optional subsections: === Anatomical Description ===, === Clinical Context ===, === Simulation Considerations ===. If Simulation Considerations is included, content must be source-traced. Leave empty or omit if not needed.	See Examples section.
tdb_structure_template_params	Optional (conditional)	String	Parameters passed to the {{TissueDB Structure}} metadata template. Used for alternative names, related structures, etc. Format: |alt_names=Abdominal fascia |related_structures=Peritoneum. Refer to {{TissueDB Structure}} template documentation for available parameters.	|alt_names=Abdominal fascia
tdb_notice_custom	Optional	String	Custom notice text that overrides or supplements the standard {{TDB notice}} block. Leave empty if using default notice.	(Rarely used; leave empty in most cases)
page_keywords	Yes	Comma-separated string	Keywords for {{Page data}} metadata. Used for search indexing. Should include the structure name and major tissue names.	Abdominal Wall, Epidermis, Dermis, Abdominal Muscle
page_description	Yes	Single sentence	One-sentence summary for {{Page data}} metadata. Describes what the structure is in plain language.	A layered anatomical structure comprising skin, fascia, and abdominal muscles.
additional_categories	Optional	Wiki links	Extra category links beyond the default [[Category:TissueDB]][[Category:TDB structures]]. Use for anatomical region categories (e.g., [[Category:Abdominal Anatomy]]).	[[Category:Abdominal Anatomy]]

The template enforces a fixed section order. Creators cannot reorder sections.

1. Lead paragraph (no header) — clinical context from lead_description
2. == Component Tissues == — table from component_tissues_table
3. At a Glance — collapsed optional section from at_a_glance_section
4. Background — collapsed optional section from background_section
5. {{TDB notice}} — standard notice block
6. {{TissueDB Structure}} — metadata template
7. {{Page data}} — metadata footer
8. Categories — [[Category:TissueDB]][[Category:TDB structures]] plus any from additional_categories

The Component Tissues table must have exactly 4 columns. Column headers are case-sensitive and must match exactly.

Column	Required?	Content Rules	Valid Examples	Invalid Examples (prohibited)
Tissue	Yes	Spelled-out anatomical tissue name (no abbreviations). Must be a real tissue type.	"Epidermis", "Dermis", "Muscularis", "Mucosa", "Submucosa"	"Epidermis (epi)", "Muscle tissue", "Simulated dermis"
Layer	Optional	Positional or directional descriptor. Optional; may be left empty.	"outer", "superficial", "middle", "deep", "deep to epidermis", "middle muscular layer"	(None — optional field)
Key Properties	Optional	Comma-separated functional or mechanical characteristics. No fidelity ratings, no materials.	"elastic, resilient, vascular", "contractile, smooth", "protective, sensory"	"Visual fidelity: high", "Uses silicone", "9/10 realism"
TissueDB Page	Yes	Wiki link to TissueDB/Tissues/[Tissue_Name]. Link is mandatory. If tissue page does not exist, create a stub before publication.	Epidermis Abdominal Muscle	"Epidermis (see Tissues page)" (unlinkable text) "Epidermis" (link without TissueDB namespace)

Example row (correct):

| [[TissueDB/Tissues/Epidermis|Epidermis]] || outer || protective, sensory || [[TissueDB/Tissues/Epidermis|Epidermis]]

The following content types cannot appear on a structure page:

• Instructions or build steps — "Structures are a finding page only". Instructions belong on Simulator pages.
• Materials or material content — "Structures have tissues only". Materials belong on Materials pages.
• Substitutions or alternatives — Belongs on Materials pages.
• License Plate section — "License plates are Materials-page-only".
• Antiskills or warnings — "Antiskills are simulator-specific". Belongs on Simulator pages or SELF Modules.
• Vegan/Halal/Cultural flags — "Tissues have no culture".
• Fidelity ratings (Visual, Tactile, Functional, Feedback columns) — Fidelity is a tissue-page concept, not a structure concept. The Component Tissues Table does not include fidelity columns.
• Simulation Requirements (4-Domain) — Belongs on Tissues pages only.
• Features, Basic Operation, or pedagogical content — Belongs in SELF Modules.
• Version history or development notes — "Current version only".
• Simulator listings or cross-references — Structure pages link to Tissue pages ONLY. Simulators are accessible via Tissue pages or Materials pages.
• Unsourced Simulation Considerations — If Simulation Considerations subsection is included in Background, content must be source-traced.

The template structure itself prevents most of these by not providing parameter fields for them. Creators would have to deliberately break the template to inject prohibited content — making violations detectable during audit.

{{TissueDB Structure
| page_title = TissueDB/Structures/Heart
| lead_description = The heart is a muscular organ that pumps blood throughout the body. Adult human hearts are approximately 12 cm (5 in) wide and 8 cm (3 in) deep. Understanding cardiac anatomy is essential for cardiac surgical procedures and cardiac emergencies.
| component_tissues_table =
{| class="wikitable"
! Tissue !! Layer !! Key Properties !! TissueDB Page
|-
| [[TissueDB/Tissues/Myocardium|Myocardium]] || middle || contractile, rhythmic || [[TissueDB/Tissues/Myocardium|Myocardium]]
|-
| [[TissueDB/Tissues/Epicardium|Epicardium]] || outer || smooth, protective || [[TissueDB/Tissues/Epicardium|Epicardium]]
|-
| [[TissueDB/Tissues/Endocardium|Endocardium]] || inner || smooth, regulates flow || [[TissueDB/Tissues/Endocardium|Endocardium]]
|}
| page_keywords = Heart, Myocardium, Epicardium, Endocardium, Cardiac
| page_description = A muscular organ comprising three primary tissue layers that pump blood throughout the body.
}}

{{TissueDB Structure
| page_title = TissueDB/Structures/Abdominal_Wall
| lead_description = The abdominal wall is a layered structure comprising skin, fascia, and abdominal muscles (45–50 cm width in adults). It provides structural support, protects abdominal organs, and is critical to understand for abdominal surgical procedures and physical examination.
| component_tissues_table =
{| class="wikitable"
! Tissue !! Layer !! Key Properties !! TissueDB Page
|-
| [[TissueDB/Tissues/Epidermis|Epidermis]] || outer || protective, sensory || [[TissueDB/Tissues/Epidermis|Epidermis]]
|-
| [[TissueDB/Tissues/Dermis|Dermis]] || deep to epidermis || elastic, resilient, vascular || [[TissueDB/Tissues/Dermis|Dermis]]
|-
| [[TissueDB/Tissues/Subcutaneous_Tissue|Subcutaneous Tissue]] || middle || insulating, fatty || [[TissueDB/Tissues/Subcutaneous_Tissue|Subcutaneous Tissue]]
|-
| [[TissueDB/Tissues/Abdominal_Fascia|Abdominal Fascia]] || middle muscular layer || supportive, connective || [[TissueDB/Tissues/Abdominal_Fascia|Abdominal Fascia]]
|-
| [[TissueDB/Tissues/Abdominal_Muscle|Abdominal Muscle]] || deep muscular || contractile, provides structure || [[TissueDB/Tissues/Abdominal_Muscle|Abdominal Muscle]]
|}
| at_a_glance_section = '''Layers:''' 5 primary tissue types. '''Clinical relevance:''' Critical for understanding surgical access and anatomy during abdominal procedures.
| background_section =
=== Anatomical Description ===
The abdominal wall traditionally is described as having multiple layers. The skin (epidermis and dermis) forms the outermost protective barrier. Beneath the skin lies subcutaneous tissue, which provides insulation and nutrient reserves. The muscular layer comprises the rectus abdominis, external oblique, internal oblique, and transversus abdominis muscles, which collectively support the abdomen and enable trunk movement.

=== Clinical Context ===
Understanding abdominal wall anatomy is essential for a wide range of clinical procedures. Surgeons must navigate the layers carefully during abdominal access to minimize tissue trauma and bleeding. Physical examination techniques require palpation through multiple layers to assess organ position and tenderness. Emergency medicine practitioners must rapidly assess abdominal wall integrity in trauma cases.

=== Simulation Considerations ===
Simulators representing the abdominal wall must capture the tactile feedback of distinct tissue layers, the resistance of fascia, and the visual appearance of layered anatomy. The ability to practice incision techniques while respecting anatomical planes is critical for trainees. [Source: ALL-SAFE Consortium Curriculum, 2024]
| tdb_structure_template_params = |alt_names=Abdominal fascia
| page_keywords = Abdominal Wall, Epidermis, Dermis, Subcutaneous Tissue, Abdominal Fascia, Abdominal Muscle, Surgical Access
| page_description = A layered anatomical structure comprising skin, fascia, and abdominal muscles that provides structural support and protects abdominal organs.
| additional_categories = [[Category:Abdominal Anatomy]][[Category:Surgical Anatomy]]
}}

All measurements in lead_description and background_section must follow metric-first format: "X cm (Y in)", "X kg (Y lbs)", "X mL (Y fl oz)". Examples:

• ✓ Correct: "approximately 12 cm (5 in) wide"
• ✓ Correct: "45–50 cm (18–20 in) width"
• ✗ Incorrect: "approximately 5 inches wide"

Tissue links must follow the standard MediaWiki format:

[[Page Name|Display Text]]

Example:

[[TissueDB/Tissues/Epidermis|Epidermis]]

This renders as a clickable link displaying "Epidermis" that points to TissueDB/Tissues/Epidermis.

Optional sections (At a Glance, Background) are rendered in HTML5 <details> tags, which produce a collapsible container. The section title appears in a <summary> element, and content is hidden until the user clicks to expand.

Modern MediaWiki installations support this syntax natively. If the wiki does not support <details>, pages will display the expanded content without collapse functionality (degraded but readable).

If a tissue entry in the Component Tissues Table links to a page that does not exist, the link will display as a red link (broken link). Before publishing, creators must create a stub page for any missing tissues.

Stub pages should minimally include:

• {{TissueDB Tissue}} template with basic parameters
• One-sentence description
• Category links

See TissueDB/Tissues/ namespace for examples of stub pages.

If the background_section includes a Simulation Considerations subsection, all content must be source-traced to one of:

• Published curriculum (with citation: "Source: [Curriculum Name], [Year]")
• Existing published TissueDB page content
• Expert review documentation
• Peer-reviewed literature

Unsourced content is prohibited, even if plausible. Sources must be cited in-text or as footnotes.

Example (correct):

=== Simulation Considerations ===
Simulators representing the abdominal wall must capture the tactile feedback of distinct tissue layers, the resistance of fascia, and the visual appearance of layered anatomy. [Source: ALL-SAFE Consortium Curriculum, 2024]

Example (incorrect):

=== Simulation Considerations ===
Simulators should realistically depict all five tissue layers with accurate coloration and texture to maximize learning outcomes for trainees.

(The second example lacks a source citation and appears to be synthesized rather than traced to documentation.)

Version	Date	Changes
v1.1	14 March 2026	Removed Simulators section. Structure pages are finding pages that link to Tissue pages only; simulator navigation occurs through Tissue and Materials pages.
1.0	14 March 2026	Initial template skeleton and documentation subpage. Based on live Abdominal Wall and Peritoneum structure pages. Enforces tissue link requirements, metric measurements with imperial equivalents, and source traceability. All parameters documented with examples.