From e96a45c949a25f9224c5bdf9a237581544f88db1 Mon Sep 17 00:00:00 2001 From: Missy Fox <137104831+missysuperdoc@users.noreply.github.com> Date: Mon, 2 Feb 2026 22:49:02 -0700 Subject: [PATCH 1/2] Create core_rendering_feature_ticket.md This is a linear template for creating tickets for core features. Added here in the main repo to streamline ticket creation through Codex/your AI of choice. Appropriate for end-user-designated features such as: table shading, charts, citations etc --- .../linear/core_rendering_feature_ticket.md | 82 +++++++++++++++++++ 1 file changed, 82 insertions(+) create mode 100644 templates/linear/core_rendering_feature_ticket.md diff --git a/templates/linear/core_rendering_feature_ticket.md b/templates/linear/core_rendering_feature_ticket.md new file mode 100644 index 0000000000..3085734aa5 --- /dev/null +++ b/templates/linear/core_rendering_feature_ticket.md @@ -0,0 +1,82 @@ +# Rendering Support: {{feature_name}} + +## Summary +Ensure {{feature_name}} renders correctly across all supported Word content containers and respects all applicable style sources (direct formatting, styles, themes). + +--- + +## Requirements + +### Feature Support +Support rendering {{feature_name}} applied at: +- {{application_level_1}} (e.g., table-level) +- {{application_level_2}} (e.g., cell-level) +- {{application_level_3}} (e.g., custom/partial application) + +Support all relevant feature attributes, including: +- {{attribute_1}} (e.g., styles) +- {{attribute_2}} (e.g., colors) +- {{attribute_3}} (e.g., widths) + +--- + +## Containers +Rendering must work consistently when {{feature_name}} appears within: + +- Main document: `w:document/w:body` +- Tables: `w:tbl` / `w:tr` / `w:tc` +- Headers / Footers parts: `w:hdr`, `w:ftr` + *(referenced via `w:sectPr` → `w:headerReference` / `w:footerReference`)* +- Structured content: `w:sdt` → `w:sdtContent` +- Textboxes / shapes text: `w:txbxContent` + *(reachable via `w:drawing` and legacy `w:pict`)* +- Footnotes: `w:footnotes` +- Endnotes: `w:endnotes` +- Comments: `w:comments` + +--- + +## Styles / Inheritance +Rendering must respect the full style cascade, including: +- **Direct formatting** (content XML): `w:*Pr` +- **Applied styles**: paragraph (`w:pStyle`), character (`w:rStyle`), table (`w:tblStyle`) +- **Style inheritance**: `w:style/w:basedOn`, linked styles +- **Style defaults**: `styles.xml` → `w:docDefaults` and default styles +- **List/numbering levels** (if applicable): `numbering.xml` → `w:lvl/*Pr` +- **Themes** (attribute-level): `themeColor`, `*Theme`, resolved via `theme/theme1.xml` + +Direct formatting overrides all other sources. + +--- + +## Acceptance Criteria +- {{feature_name}} renders identically to Word in all listed containers. +- {{feature_name}} renders identically to Word regardless of how styles are applied/inherited. + +--- + +## Test Coverage + +Add fixtures covering {{feature_name}} applied via: +- Direct formatting +- Character style +- Paragraph style +- Document defaults + +Each fixture must include: +- Body +- Table +- Header / footer +- Structured content +- Textbox +- List + +--- + +## Sample Documents +{{sample_docs_or_links}} + +--- + +## Notes / Edge Cases / Out of Scope +{{notes}} From 37fbeb3bdce9df8ea1b1e3c3bbfb53b38ad8f109 Mon Sep 17 00:00:00 2001 From: Missy Fox <137104831+missysuperdoc@users.noreply.github.com> Date: Fri, 6 Feb 2026 12:28:28 -0700 Subject: [PATCH 2/2] Core_rendering_feature_ticket_template.md Updated the template based on feedback from Luccas in SD meeting this week. --- .../linear/core_rendering_feature_ticket.md | 88 +++++++------------ 1 file changed, 34 insertions(+), 54 deletions(-) diff --git a/templates/linear/core_rendering_feature_ticket.md b/templates/linear/core_rendering_feature_ticket.md index 3085734aa5..46730b0632 100644 --- a/templates/linear/core_rendering_feature_ticket.md +++ b/templates/linear/core_rendering_feature_ticket.md @@ -1,82 +1,62 @@ -# Rendering Support: {{feature_name}} +## Rendering Feature: [FEATURE NAME] -## Summary -Ensure {{feature_name}} renders correctly across all supported Word content containers and respects all applicable style sources (direct formatting, styles, themes). +### Summary +Ensure [FEATURE NAME] renders correctly across all supported Word content containers and respects all applicable style sources (direct formatting, styles, themes). ---- +### Requirements -## Requirements +**Containers:** -### Feature Support -Support rendering {{feature_name}} applied at: -- {{application_level_1}} (e.g., table-level) -- {{application_level_2}} (e.g., cell-level) -- {{application_level_3}} (e.g., custom/partial application) +Rendering must work consistently when [FEATURE NAME] appears in: -Support all relevant feature attributes, including: -- {{attribute_1}} (e.g., styles) -- {{attribute_2}} (e.g., colors) -- {{attribute_3}} (e.g., widths) +- Document body (w:body) +- Paragraphs (w:p) +- Lists +- Tables (w:tbl) +- Headers & footers (w:hdr, w:ftr) +- Textboxes / shapes (w:txbxContent) +- Structured content / content controls (w:sdtContent) +- Footnotes: w:footnotes +- Endnotes: w:endnotes ---- +### Acceptance Criteria -## Containers -Rendering must work consistently when {{feature_name}} appears within: +- [FEATURE NAME] render identically in all listed containers. +- Behavior is consistent regardless of how the feature is applied (manual, style, defaults). +- Mixed usage (feature on/off within the same paragraph/run group) renders correctly. +- No container-specific rendering differences. -- Main document: `w:document/w:body` -- Tables: `w:tbl` / `w:tr` / `w:tc` -- Headers / Footers parts: `w:hdr`, `w:ftr` - *(referenced via `w:sectPr` → `w:headerReference` / `w:footerReference`)* -- Structured content: `w:sdt` → `w:sdtContent` -- Textboxes / shapes text: `w:txbxContent` - *(reachable via `w:drawing` and legacy `w:pict`)* -- Footnotes: `w:footnotes` -- Endnotes: `w:endnotes` -- Comments: `w:comments` +### Styles / Inheritance — should be applied in a centralized way already: ---- - -## Styles / Inheritance Rendering must respect the full style cascade, including: -- **Direct formatting** (content XML): `w:*Pr` -- **Applied styles**: paragraph (`w:pStyle`), character (`w:rStyle`), table (`w:tblStyle`) -- **Style inheritance**: `w:style/w:basedOn`, linked styles -- **Style defaults**: `styles.xml` → `w:docDefaults` and default styles -- **List/numbering levels** (if applicable): `numbering.xml` → `w:lvl/*Pr` -- **Themes** (attribute-level): `themeColor`, `*Theme`, resolved via `theme/theme1.xml` - -Direct formatting overrides all other sources. ---- +- Direct formatting (content XML): w:*Pr +- Applied styles: paragraph (w:pStyle), character (w:rStyle), table (w:tblStyle) +- Style inheritance: w:style/w:basedOn, linked styles +- Style defaults: styles.xml → w:docDefaults and default styles +- List / numbering levels (if applicable): numbering.xml → w:lvl/*Pr +- Themes (attribute-level): themeColor, *Theme, resolved via theme/theme1.xml -## Acceptance Criteria -- {{feature_name}} renders identically to Word in all listed containers. -- {{feature_name}} renders identically to Word regardless of how styles are applied/inherited. +### Sample Docs: ---- +### Test Coverage -## Test Coverage +Add fixtures covering [FEATURE NAME] applied via: -Add fixtures covering {{feature_name}} applied via: - Direct formatting - Character style - Paragraph style - Document defaults Each fixture must include: + - Body - Table -- Header / footer +- Header/footer - Structured content - Textbox - List ---- - -## Sample Documents -{{sample_docs_or_links}} - ---- +### Notes / Edge Cases / Out of Scope -## Notes / Edge Cases / Out of Scope -{{notes}} +[Optional — only if known]