3GPP TDoc Drafting
Use this skill for 3GPP-specific document structure, metadata conventions,
and concrete Word style names. For formatting rules (headings, enumerations,
notes, tables, figures, citations), see sdo-docx-formatting. For officecli
operations (tab-run injection, field codes, bookmarks), see
sdo-docx-operations.
Assets
assets/Tdoc_Template.docx -- canonical Word template with all required
3GPP styles. Copy to ref/Tdoc_Template.docx when initializing a new
project (see sdo-project-setup for the common project bootstrap workflow).
This is a user-crafted file containing all required styles
(B1, B2, NO, NW, TH, TAH, TF, EX, PL, etc.) and is
not tied to an official 3GPP release cycle.
References
references/frontmatter.md -- 3GPP-specific PLAN.md metadata keys.references/template-substitution.md -- Jinja2 placeholder substitution
for the 3GPP TDoc template.references/revision-workflow.md -- 3GPP-specific header structure and
copy-rename-patch procedure for revisions.
Moved to sdo-project-setup: project layout, AGENTS.md template,
universal project prompt, and set_docx_props.py (now generalized with a
--props parameter). Load sdo-project-setup for these common functions.
3GPP style-name mapping
Concrete Word style IDs for 3GPP documents. Use these when applying
formatting rules from sdo-docx-formatting.
Abstract name (sdo-docx-formatting) |
3GPP concrete style ID |
Purpose |
body-text |
Normal |
Main body paragraphs |
heading-1 |
Heading 1 |
Top-level section heading |
heading-2 |
Heading 2 |
Second-level section heading |
heading-3 |
Heading 3 |
Third-level section heading |
enum-1 |
B1 |
First-level enumeration (en-dash bullet) |
enum-2 |
B2 |
Second-level enumeration |
enum-3 |
B3 |
Third-level enumeration (if used) |
table-caption |
TH |
Table caption (above table) |
table-header |
TAH |
Table header row |
table-data |
TAC |
Table data rows |
table-note |
TAN |
Table merged-bottom-row note |
figure-para |
FL |
Paragraph containing image |
figure-caption |
TF |
Figure caption (below figure) |
figure-note |
NF |
Note below figure, before caption |
note-main |
NO |
Last note in a consecutive block |
note-continuation |
NW |
Preceding notes in a block |
reference-entry |
EX |
Each references section entry |
code-text |
PL |
Inline code, function/variable names, filenames |
Additional 3GPP-specific styles (no abstract equivalent):
| Style ID |
Purpose |
TDoc-Header |
Cover page header paragraphs (TDoc number, date, source, title, agenda item, target) |
Heading conventions (3GPP-specific override)
3GPP headings use manual numbering only (never Word auto-numbering).
See sdo-docx-formatting/references/headings.md for full rules. The
References section is unnumbered and always the last section.
Cross-references
sdo-project-setup -- common project bootstrap (layout, metadata sync, autodetection)sdo-docx-formatting -- formatting rules (delegated; see mapping above)sdo-docx-operations -- officecli guardrails for raw-set, field codes, bookmarkssdo-writing-style -- prose quality rulessdo-writing-conventions -- mechanical writing rules (spelling, numbers, abbreviations)3gpp-basics -- 3GPP organisation context3gpp-meetings -- meeting structure and identifiers3gpp-tdocs -- TDoc numbering patterns and FTP access3gpp-change-request -- CR procedure when the contribution is a CR
1---2name: 3gpp-drafting3description: 3GPP-specific TDoc authoring conventions: metadata schema, template substitution, revision workflow, DOCX property sync, project layout, and 3GPP style-name mapping. Use when preparing, updating, or validating 3GPP TDoc .docx files for meeting submissions. Delegates formatting rules to sdo-docx-formatting and officecli operations to sdo-docx-operations.4---56# 3GPP TDoc Drafting78Use this skill for 3GPP-specific document structure, metadata conventions,9and concrete Word style names. For formatting rules (headings, enumerations,10notes, tables, figures, citations), see `sdo-docx-formatting`. For officecli11operations (tab-run injection, field codes, bookmarks), see12`sdo-docx-operations`.1314## Assets1516- `assets/Tdoc_Template.docx` -- canonical Word template with all required17 3GPP styles. Copy to `ref/Tdoc_Template.docx` when initializing a new18 project (see `sdo-project-setup` for the common project bootstrap workflow).19 This is a user-crafted file containing all required styles20 (`B1`, `B2`, `NO`, `NW`, `TH`, `TAH`, `TF`, `EX`, `PL`, etc.) and is21 **not** tied to an official 3GPP release cycle.2223## References2425- `references/frontmatter.md` -- 3GPP-specific PLAN.md metadata keys.26- `references/template-substitution.md` -- Jinja2 placeholder substitution27 for the 3GPP TDoc template.28- `references/revision-workflow.md` -- 3GPP-specific header structure and29 copy-rename-patch procedure for revisions.3031> **Moved to `sdo-project-setup`:** project layout, AGENTS.md template,32> universal project prompt, and `set_docx_props.py` (now generalized with a33> `--props` parameter). Load `sdo-project-setup` for these common functions.3435______________________________________________________________________3637## 3GPP style-name mapping3839Concrete Word style IDs for 3GPP documents. Use these when applying40formatting rules from `sdo-docx-formatting`.4142| Abstract name (`sdo-docx-formatting`) | 3GPP concrete style ID | Purpose |43|---|---|---|44| `body-text` | `Normal` | Main body paragraphs |45| `heading-1` | `Heading 1` | Top-level section heading |46| `heading-2` | `Heading 2` | Second-level section heading |47| `heading-3` | `Heading 3` | Third-level section heading |48| `enum-1` | `B1` | First-level enumeration (en-dash bullet) |49| `enum-2` | `B2` | Second-level enumeration |50| `enum-3` | `B3` | Third-level enumeration (if used) |51| `table-caption` | `TH` | Table caption (above table) |52| `table-header` | `TAH` | Table header row |53| `table-data` | `TAC` | Table data rows |54| `table-note` | `TAN` | Table merged-bottom-row note |55| `figure-para` | `FL` | Paragraph containing image |56| `figure-caption` | `TF` | Figure caption (below figure) |57| `figure-note` | `NF` | Note below figure, before caption |58| `note-main` | `NO` | Last note in a consecutive block |59| `note-continuation` | `NW` | Preceding notes in a block |60| `reference-entry` | `EX` | Each references section entry |61| `code-text` | `PL` | Inline code, function/variable names, filenames |6263Additional 3GPP-specific styles (no abstract equivalent):6465| Style ID | Purpose |66|----------|---------|67| `TDoc-Header` | Cover page header paragraphs (TDoc number, date, source, title, agenda item, target) |6869## Heading conventions (3GPP-specific override)70713GPP headings use **manual numbering only** (never Word auto-numbering).72See `sdo-docx-formatting/references/headings.md` for full rules. The73`References` section is unnumbered and always the last section.7475## Cross-references7677- `sdo-project-setup` -- common project bootstrap (layout, metadata sync, autodetection)78- `sdo-docx-formatting` -- formatting rules (delegated; see mapping above)79- `sdo-docx-operations` -- officecli guardrails for raw-set, field codes, bookmarks80- `sdo-writing-style` -- prose quality rules81- `sdo-writing-conventions` -- mechanical writing rules (spelling, numbers, abbreviations)82- `3gpp-basics` -- 3GPP organisation context83- `3gpp-meetings` -- meeting structure and identifiers84- `3gpp-tdocs` -- TDoc numbering patterns and FTP access85- `3gpp-change-request` -- CR procedure when the contribution is a CR
jr2804