From cfa657d626c04eb9bcf093bb50c33b1af90dbfca Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 23 Jan 2026 20:56:11 +0000 Subject: [PATCH 1/5] Initial plan From e9a0708a774c870a295ef60fc847fb634d0026d4 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 23 Jan 2026 21:04:07 +0000 Subject: [PATCH 2/5] Add formatting-a-draft section and split previewing into separate page Co-authored-by: Nateowami <6140710+Nateowami@users.noreply.github.com> --- docs/Draft-Generation/formatting-a-draft.md | 72 +++++++++++++++++++++ docs/Draft-Generation/previewing-a-draft.md | 17 +++++ docs/Draft-Generation/using-a-draft.md | 16 +---- 3 files changed, 90 insertions(+), 15 deletions(-) create mode 100644 docs/Draft-Generation/formatting-a-draft.md create mode 100644 docs/Draft-Generation/previewing-a-draft.md diff --git a/docs/Draft-Generation/formatting-a-draft.md b/docs/Draft-Generation/formatting-a-draft.md new file mode 100644 index 0000000..54465eb --- /dev/null +++ b/docs/Draft-Generation/formatting-a-draft.md @@ -0,0 +1,72 @@ +--- +title: Formatting a draft +sidebar_position: 3 +slug: /formatting-a-draft +--- + +## Introduction + +When you generate a draft in Scripture Forge for the first time, you will need to select formatting options that control how the draft is generated. These formatting options determine how the AI model processes and outputs the translated text. + +## First-time setup + +The first time you generate a draft for your project, you will be prompted to select formatting options. These options are required to ensure the draft is generated according to your project's needs and preferences. + +Once you've selected formatting options for the first time, Scripture Forge will remember your selections and automatically use the same options for future drafts. This means you won't need to configure these settings each time you generate a new draft. + +## Changing formatting options + +While your initial formatting selections are saved and reused automatically, you can change these options at any time when generating a new draft. This flexibility allows you to experiment with different settings or adjust the formatting as your project needs evolve. + +To change the formatting options for a new draft: + +1. Navigate to the **Generate draft** page +2. Click on the option to configure or change formatting settings +3. Select your preferred formatting options +4. Continue with the draft generation process + +## Available formatting options + +Scripture Forge provides several formatting options to customize how your draft is generated: + +### Text formatting + +These options control how the text is structured and formatted in the output: + +- **Verse numbering**: Choose how verse numbers are displayed in the draft (inline, separate, or omitted) +- **Paragraph breaks**: Control how paragraph breaks from the source text are preserved or adapted in the draft +- **Poetry formatting**: Determine how poetic passages are formatted to maintain their structure + +### Punctuation and typography + +These settings manage punctuation and typographic elements: + +- **Quotation marks**: Select the style of quotation marks used in the draft (straight quotes, curly quotes, or language-specific markers) +- **Punctuation adaptation**: Choose whether punctuation from the source text should be adapted to match the target language conventions + +### Special text handling + +Options for handling specific types of biblical text: + +- **Section headings**: Decide whether section headings should be included or translated in the draft +- **Cross-references and footnotes**: Control how cross-references and footnotes are handled during draft generation +- **Divine names**: Configure how divine names (like "LORD" or "God") are rendered in the target language + +## Best practices + +When selecting formatting options: + +- **Start with defaults**: For your first draft, consider using the recommended default settings +- **Review sample output**: After generating a draft with specific settings, review the output to ensure it meets your needs +- **Maintain consistency**: Once you find settings that work well, use them consistently across your drafts +- **Consult your team**: Discuss formatting choices with your translation team to ensure they align with your project standards + +## Getting help + +If you're unsure which formatting options to select, or if you have questions about how specific options affect the draft output, you can: + +- Contact the Scripture Forge support team for guidance +- Review sample drafts with different formatting options to see the differences +- Consult with your translation consultant or project manager + +Remember that formatting options can be changed for future drafts, so you can adjust your selections as you learn what works best for your project. diff --git a/docs/Draft-Generation/previewing-a-draft.md b/docs/Draft-Generation/previewing-a-draft.md new file mode 100644 index 0000000..0843984 --- /dev/null +++ b/docs/Draft-Generation/previewing-a-draft.md @@ -0,0 +1,17 @@ +--- +title: Previewing a draft +sidebar_position: 4 +slug: /previewing-a-draft +--- + +Click on a book title to view the draft. The draft will open in a new tab on the editor page. + +:::tip + +To compare the draft to the text it was translated from, set a source on the settings page. This will allow you to see a source and the resulting draft side-by-side. + +If you drafted a book the team has already finished translating, you can move the draft tab to the other side of the page, and compare it with the team's translation. + +::: + +![](./draft_preview.png) diff --git a/docs/Draft-Generation/using-a-draft.md b/docs/Draft-Generation/using-a-draft.md index 99cc402..3a06bf1 100644 --- a/docs/Draft-Generation/using-a-draft.md +++ b/docs/Draft-Generation/using-a-draft.md @@ -1,6 +1,6 @@ --- title: Using a draft -sidebar_position: 2 +sidebar_position: 2.5 slug: /using-a-draft --- @@ -11,20 +11,6 @@ When your draft is finished, Scripture Forge will indicate that it's ready and l ![](./draft_complete.png) -## Previewing a draft - -Click on a book title to view the draft. The draft will open in a new tab on the editor page. - -:::tip - -To compare the draft to the text it was translated from, set a source on the settings page. This will allow you to see a source and the resulting draft side-by-side. - -If you drafted a book the team has already finished translating, you can move the draft tab to the other side of the page, and compare it with the team's translation. - -::: - -![](./draft_preview.png) - ## Importing a single chapter When previewing the draft, you can import the draft of the current chapter into the project by clicking "Add to project". You can go to each chapter in the book and preview and import each chapter one at a time. This will add the chapter to the current project; not to a different project. From 568b6cc63902f2b632f09ab4236c918efe8f14b9 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 23 Jan 2026 21:05:11 +0000 Subject: [PATCH 3/5] Revise formatting-a-draft content to be more accurate and general Co-authored-by: Nateowami <6140710+Nateowami@users.noreply.github.com> --- docs/Draft-Generation/formatting-a-draft.md | 65 ++++++--------------- 1 file changed, 17 insertions(+), 48 deletions(-) diff --git a/docs/Draft-Generation/formatting-a-draft.md b/docs/Draft-Generation/formatting-a-draft.md index 54465eb..86e97fb 100644 --- a/docs/Draft-Generation/formatting-a-draft.md +++ b/docs/Draft-Generation/formatting-a-draft.md @@ -4,69 +4,38 @@ sidebar_position: 3 slug: /formatting-a-draft --- -## Introduction +## What are formatting options? -When you generate a draft in Scripture Forge for the first time, you will need to select formatting options that control how the draft is generated. These formatting options determine how the AI model processes and outputs the translated text. +When you generate a draft in Scripture Forge, you can select formatting options that control how the draft text is structured and presented. These options help ensure that the generated draft matches your project's formatting needs and conventions. ## First-time setup -The first time you generate a draft for your project, you will be prompted to select formatting options. These options are required to ensure the draft is generated according to your project's needs and preferences. +The first time you generate a draft for your project, you will be required to select formatting options. This is a necessary step to ensure the draft is generated according to your project's requirements. -Once you've selected formatting options for the first time, Scripture Forge will remember your selections and automatically use the same options for future drafts. This means you won't need to configure these settings each time you generate a new draft. +Once you've selected formatting options for the first time, Scripture Forge will remember your selections. The same formatting options will be used automatically for all future drafts, so you won't need to configure these settings again. ## Changing formatting options -While your initial formatting selections are saved and reused automatically, you can change these options at any time when generating a new draft. This flexibility allows you to experiment with different settings or adjust the formatting as your project needs evolve. +While your initial formatting selections are saved and reused automatically, you can choose different options at any time when generating a new draft. This allows you to adjust the formatting if your project's needs change or if you want to experiment with different settings. -To change the formatting options for a new draft: +## Understanding the options -1. Navigate to the **Generate draft** page -2. Click on the option to configure or change formatting settings -3. Select your preferred formatting options -4. Continue with the draft generation process +The formatting options control various aspects of how the draft text is structured, including: -## Available formatting options +- How verses and paragraphs are formatted +- How special text elements like poetry, lists, or quotations are handled +- What punctuation and spacing conventions are applied +- How section headings and other structural elements are formatted -Scripture Forge provides several formatting options to customize how your draft is generated: - -### Text formatting - -These options control how the text is structured and formatted in the output: - -- **Verse numbering**: Choose how verse numbers are displayed in the draft (inline, separate, or omitted) -- **Paragraph breaks**: Control how paragraph breaks from the source text are preserved or adapted in the draft -- **Poetry formatting**: Determine how poetic passages are formatted to maintain their structure - -### Punctuation and typography - -These settings manage punctuation and typographic elements: - -- **Quotation marks**: Select the style of quotation marks used in the draft (straight quotes, curly quotes, or language-specific markers) -- **Punctuation adaptation**: Choose whether punctuation from the source text should be adapted to match the target language conventions - -### Special text handling - -Options for handling specific types of biblical text: - -- **Section headings**: Decide whether section headings should be included or translated in the draft -- **Cross-references and footnotes**: Control how cross-references and footnotes are handled during draft generation -- **Divine names**: Configure how divine names (like "LORD" or "God") are rendered in the target language +The specific options available will depend on your project type and the source texts you are translating from. During the draft generation process, you'll be presented with the available options and can select the ones that best fit your project. ## Best practices When selecting formatting options: -- **Start with defaults**: For your first draft, consider using the recommended default settings -- **Review sample output**: After generating a draft with specific settings, review the output to ensure it meets your needs -- **Maintain consistency**: Once you find settings that work well, use them consistently across your drafts -- **Consult your team**: Discuss formatting choices with your translation team to ensure they align with your project standards - -## Getting help - -If you're unsure which formatting options to select, or if you have questions about how specific options affect the draft output, you can: - -- Contact the Scripture Forge support team for guidance -- Review sample drafts with different formatting options to see the differences -- Consult with your translation consultant or project manager +- **Review the defaults**: The default options are chosen to work well for most projects +- **Think about your workflow**: Consider how the draft will be used and edited by your team +- **Be consistent**: Using the same formatting options for all drafts in your project helps maintain consistency +- **Ask for help if needed**: If you're unsure which options to choose, contact the Scripture Forge support team or your translation consultant -Remember that formatting options can be changed for future drafts, so you can adjust your selections as you learn what works best for your project. +Remember that you can always change the formatting options for future drafts if you find that different settings work better for your project. From da7ab6e0214fa5f9d93b9baa2ff57bea66068236 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 23 Jan 2026 21:06:11 +0000 Subject: [PATCH 4/5] Use integer sidebar positions instead of decimals Co-authored-by: Nateowami <6140710+Nateowami@users.noreply.github.com> --- docs/Draft-Generation/formatting-a-draft.md | 2 +- docs/Draft-Generation/previewing-a-draft.md | 2 +- docs/Draft-Generation/using-a-draft.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/Draft-Generation/formatting-a-draft.md b/docs/Draft-Generation/formatting-a-draft.md index 86e97fb..4f65cd4 100644 --- a/docs/Draft-Generation/formatting-a-draft.md +++ b/docs/Draft-Generation/formatting-a-draft.md @@ -1,6 +1,6 @@ --- title: Formatting a draft -sidebar_position: 3 +sidebar_position: 4 slug: /formatting-a-draft --- diff --git a/docs/Draft-Generation/previewing-a-draft.md b/docs/Draft-Generation/previewing-a-draft.md index 0843984..d552243 100644 --- a/docs/Draft-Generation/previewing-a-draft.md +++ b/docs/Draft-Generation/previewing-a-draft.md @@ -1,6 +1,6 @@ --- title: Previewing a draft -sidebar_position: 4 +sidebar_position: 5 slug: /previewing-a-draft --- diff --git a/docs/Draft-Generation/using-a-draft.md b/docs/Draft-Generation/using-a-draft.md index 3a06bf1..0386a82 100644 --- a/docs/Draft-Generation/using-a-draft.md +++ b/docs/Draft-Generation/using-a-draft.md @@ -1,6 +1,6 @@ --- title: Using a draft -sidebar_position: 2.5 +sidebar_position: 3 slug: /using-a-draft --- From a68e304711a44982ad44a459d5788dd309a4c369 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 23 Jan 2026 23:19:25 +0000 Subject: [PATCH 5/5] Restore previewing section to using-a-draft and reorder navigation Co-authored-by: Nateowami <6140710+Nateowami@users.noreply.github.com> --- docs/Draft-Generation/formatting-a-draft.md | 2 +- docs/Draft-Generation/previewing-a-draft.md | 17 ----------------- docs/Draft-Generation/using-a-draft.md | 14 ++++++++++++++ 3 files changed, 15 insertions(+), 18 deletions(-) delete mode 100644 docs/Draft-Generation/previewing-a-draft.md diff --git a/docs/Draft-Generation/formatting-a-draft.md b/docs/Draft-Generation/formatting-a-draft.md index 4f65cd4..8f25696 100644 --- a/docs/Draft-Generation/formatting-a-draft.md +++ b/docs/Draft-Generation/formatting-a-draft.md @@ -1,6 +1,6 @@ --- title: Formatting a draft -sidebar_position: 4 +sidebar_position: 2.5 slug: /formatting-a-draft --- diff --git a/docs/Draft-Generation/previewing-a-draft.md b/docs/Draft-Generation/previewing-a-draft.md deleted file mode 100644 index d552243..0000000 --- a/docs/Draft-Generation/previewing-a-draft.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: Previewing a draft -sidebar_position: 5 -slug: /previewing-a-draft ---- - -Click on a book title to view the draft. The draft will open in a new tab on the editor page. - -:::tip - -To compare the draft to the text it was translated from, set a source on the settings page. This will allow you to see a source and the resulting draft side-by-side. - -If you drafted a book the team has already finished translating, you can move the draft tab to the other side of the page, and compare it with the team's translation. - -::: - -![](./draft_preview.png) diff --git a/docs/Draft-Generation/using-a-draft.md b/docs/Draft-Generation/using-a-draft.md index 0386a82..3aae49a 100644 --- a/docs/Draft-Generation/using-a-draft.md +++ b/docs/Draft-Generation/using-a-draft.md @@ -11,6 +11,20 @@ When your draft is finished, Scripture Forge will indicate that it's ready and l ![](./draft_complete.png) +## Previewing a draft + +Click on a book title to view the draft. The draft will open in a new tab on the editor page. + +:::tip + +To compare the draft to the text it was translated from, set a source on the settings page. This will allow you to see a source and the resulting draft side-by-side. + +If you drafted a book the team has already finished translating, you can move the draft tab to the other side of the page, and compare it with the team's translation. + +::: + +![](./draft_preview.png) + ## Importing a single chapter When previewing the draft, you can import the draft of the current chapter into the project by clicking "Add to project". You can go to each chapter in the book and preview and import each chapter one at a time. This will add the chapter to the current project; not to a different project.