Skip to content

A bit clearer instructions on when to consider switching the template format up #557

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
nonprofittechy merged 1 commit into from
Sep 18, 2025
Merged

A bit clearer instructions on when to consider switching the template format up #557

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions docs/authoring/docx_templates.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,11 @@ slug: docx
---

:::tip
Consider whether to use a PDF template instead.
If strict layout and matching the original page count are important, consider whether to use a PDF template instead.

**Reasons to use DOCX:**

* DOCX documents will grow or shrink to accomodate as much or as little information as the user provides
* DOCX documents will grow or shrink to accommodate as much or as little information as the user provides
* DOCX documents allow you to use lists and repeated groups naturally and with little extra effort after labeling the first item
* DOCX documents allow you to easily make whole sections of a document contingent
* DOCX documents work well with linear content that is read by scanning down the page, not across
Expand All @@ -19,6 +19,7 @@ Consider whether to use a PDF template instead.

* DOCX documents do not work as well for content formatted in columns or that require precise layout
* DOCX document content may flow unexpectedly if it is longer than expected

:::

DOCX templates can be edited in any editor that is able to edit DOCX files, including:
Expand Down
4 changes: 2 additions & 2 deletions docs/authoring/pdf_templates.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,11 @@ slug: pdfs
---

:::tip
Consider whether to use a DOCX template instead.
If strict layout is not important, consider whether to use a DOCX template instead.

**Reasons to use PDF:**

* PDF files may be the best choice if you are automating an approved court form that already exists as a PDF
* PDF files are usually the best choice if you are automating an approved court form that already exists as a PDF
* PDF files are good for heavily formatted content that includes columns and multiple fields on a single line

**Reasons to avoid PDF:**
Expand Down