From a077ffc77ad85b5fdd3ea9630316de8740a73066 Mon Sep 17 00:00:00 2001 From: Bethany Moore Date: Tue, 11 Aug 2026 17:40:29 -0400 Subject: [PATCH 1/5] Explain Incremental Draft Generation --- docs/Draft-Generation/generating-a-draft.md | 26 +++++++++++++++++++-- 1 file changed, 24 insertions(+), 2 deletions(-) diff --git a/docs/Draft-Generation/generating-a-draft.md b/docs/Draft-Generation/generating-a-draft.md index 11c57b0..9dd155c 100644 --- a/docs/Draft-Generation/generating-a-draft.md +++ b/docs/Draft-Generation/generating-a-draft.md @@ -28,7 +28,21 @@ If you use a separate Paratext project to store AI-generated drafts, double chec ### Select the books to draft -On the second step, select the books you want translated. If the book you want to draft does not exist in your Paratext project, you will need to create the book in Paratext first. In general we suggest drafting one book at a time, though if you are drafting smaller books, you may want to draft several at a time. +On the second step, select the books you want translated. If the book you want to draft does not exist in your Paratext project, you will need to create the book in Paratext first. In general we suggest drafting one book at a time, though if you are drafting smaller books, you may want to draft several at a time. For long books, consider generating a new draft after completing a significant portion of the book. + +:::note + +If you select a book that is at least 12 chapters in length and has some text already, you will see the option to select which chapters you want to draft. If you select to draft only some chapters, you can choose some or all of the remaining chapters in the next step for training the model. + +[new screenshot needed: selecting which chapters in a book to draft] + +::: + +:::tip + +When using draft generation early in the life of a project, we recommend starting with the gospels and Acts, and generating a new draft each time 10-12 new chapters are complete. When beginning work on poetic books, we recommend generating a new draft after about 30 chapters of Psalms or 15 chapters of Proverbs. Recommendations are not yet available for all books. + +::: ![](./generate_draft_select_books_to_draft.png) @@ -38,8 +52,16 @@ On the next step, select the books to use to train the language model, both in y ![](./generate_draft_select_books_to_train.png) +:::note + +If you selected to draft only some chapters of a book in the previous step, you can choose to include all or part of the remaining chapters in training. Any chapters selected to draft will not be available for training. + +[new screenshot needed: selecting which chapters in a book to use for training] + +::: + ### Confirm your selections On the final step, review the books you selected to train the model, and the books you selected to draft. If you need to make any changes, you can go to the previous steps. Once you are happy with your selections, click the "Generate draft" button to start the process. -![](./generate_draft_summary.png) \ No newline at end of file +![](./generate_draft_summary.png) From b9dcba8da69da680038a9eafec19fad95d5a0f81 Mon Sep 17 00:00:00 2001 From: Bethany Moore Date: Tue, 11 Aug 2026 17:49:32 -0400 Subject: [PATCH 2/5] Fix note placement --- docs/Draft-Generation/generating-a-draft.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/Draft-Generation/generating-a-draft.md b/docs/Draft-Generation/generating-a-draft.md index 9dd155c..589bd23 100644 --- a/docs/Draft-Generation/generating-a-draft.md +++ b/docs/Draft-Generation/generating-a-draft.md @@ -30,6 +30,8 @@ If you use a separate Paratext project to store AI-generated drafts, double chec On the second step, select the books you want translated. If the book you want to draft does not exist in your Paratext project, you will need to create the book in Paratext first. In general we suggest drafting one book at a time, though if you are drafting smaller books, you may want to draft several at a time. For long books, consider generating a new draft after completing a significant portion of the book. +![](./generate_draft_select_books_to_draft.png) + :::note If you select a book that is at least 12 chapters in length and has some text already, you will see the option to select which chapters you want to draft. If you select to draft only some chapters, you can choose some or all of the remaining chapters in the next step for training the model. @@ -44,8 +46,6 @@ When using draft generation early in the life of a project, we recommend startin ::: -![](./generate_draft_select_books_to_draft.png) - ### Select the books to train the language model On the next step, select the books to use to train the language model, both in your main project, and in the reference projects. **Choose all the books in your project that have been adequately reviewed. While they don't need to be consultant-checked, they should be accurate translations of the source book.** From b643c2c34efb8040d9259f47931e0c739a06e408 Mon Sep 17 00:00:00 2001 From: Bethany Moore Date: Wed, 12 Aug 2026 12:08:25 -0400 Subject: [PATCH 3/5] Add instructions for chapter ranges --- docs/Draft-Generation/generating-a-draft.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/Draft-Generation/generating-a-draft.md b/docs/Draft-Generation/generating-a-draft.md index 589bd23..8d58c7a 100644 --- a/docs/Draft-Generation/generating-a-draft.md +++ b/docs/Draft-Generation/generating-a-draft.md @@ -34,7 +34,7 @@ On the second step, select the books you want translated. If the book you want t :::note -If you select a book that is at least 12 chapters in length and has some text already, you will see the option to select which chapters you want to draft. If you select to draft only some chapters, you can choose some or all of the remaining chapters in the next step for training the model. +If you select a book that is at least 12 chapters in length and contains some text already, you will see the option to select which chapters you want to draft. If you select to draft only some chapters, you will be able to choose some or all of the remaining chapters for training the model in the next step. Separate chapters with commas and use a dash for chapter ranges, as follows: 1-10,25,40-50 [new screenshot needed: selecting which chapters in a book to draft] @@ -42,7 +42,7 @@ If you select a book that is at least 12 chapters in length and has some text al :::tip -When using draft generation early in the life of a project, we recommend starting with the gospels and Acts, and generating a new draft each time 10-12 new chapters are complete. When beginning work on poetic books, we recommend generating a new draft after about 30 chapters of Psalms or 15 chapters of Proverbs. Recommendations are not yet available for all books. +When using draft generation early in the life of a project, we recommend starting with the gospels and Acts, and generating a new draft each time 8-10 new chapters are complete. When beginning work on poetic books, it may be helpful to generate a new draft after each 30-50 chapters of Psalms or 15 chapters of Proverbs. Recommendations are not yet available for all books. ::: @@ -54,7 +54,7 @@ On the next step, select the books to use to train the language model, both in y :::note -If you selected to draft only some chapters of a book in the previous step, you can choose to include all or part of the remaining chapters in training. Any chapters selected to draft will not be available for training. +If you selected to draft only some chapters of a book in the previous step, you can choose to include all or part of the remaining chapters in training. Any chapters selected to draft will not be available for training. Separate chapters with commas and use a dash for chapter ranges, as follows: 1-10,25,40-50 [new screenshot needed: selecting which chapters in a book to use for training] From f0a08b37ea90247c84a36e4aa94b03ad22cb44a4 Mon Sep 17 00:00:00 2001 From: Bethany Moore Date: Wed, 12 Aug 2026 12:24:18 -0400 Subject: [PATCH 4/5] Add link to NT Guidance --- docs/Draft-Generation/generating-a-draft.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/Draft-Generation/generating-a-draft.md b/docs/Draft-Generation/generating-a-draft.md index 8d58c7a..aa5ef35 100644 --- a/docs/Draft-Generation/generating-a-draft.md +++ b/docs/Draft-Generation/generating-a-draft.md @@ -34,7 +34,7 @@ On the second step, select the books you want translated. If the book you want t :::note -If you select a book that is at least 12 chapters in length and contains some text already, you will see the option to select which chapters you want to draft. If you select to draft only some chapters, you will be able to choose some or all of the remaining chapters for training the model in the next step. Separate chapters with commas and use a dash for chapter ranges, as follows: 1-10,25,40-50 +**Incremental Draft Generation:** If you select a book that is at least 12 chapters in length and contains some text already, you will see the option to select which chapters you want to draft. If you select to draft only some chapters, you will be able to choose some or all of the remaining chapters for training the model in the following step. Separate chapters with commas and use a dash for chapter ranges, as follows: 1-10,25,40-50 [new screenshot needed: selecting which chapters in a book to draft] @@ -42,7 +42,7 @@ If you select a book that is at least 12 chapters in length and contains some te :::tip -When using draft generation early in the life of a project, we recommend starting with the gospels and Acts, and generating a new draft each time 8-10 new chapters are complete. When beginning work on poetic books, it may be helpful to generate a new draft after each 30-50 chapters of Psalms or 15 chapters of Proverbs. Recommendations are not yet available for all books. +When using draft generation early in the life of a project, we recommend starting with the gospels and Acts, and generating a new draft each time 8-10 new chapters are complete. See [Guidelines for New Testament Draft Generation](https://help.scriptureforge.org/new-testament-drafting). When beginning work on poetic books, it may be helpful to generate a new draft after each 30-50 chapters of Psalms or 15 chapters of Proverbs. Recommendations are not yet available for all books. ::: From 867a0dd401341cee15496c13c892f0b10ab4e035 Mon Sep 17 00:00:00 2001 From: Bethany Moore Date: Wed, 12 Aug 2026 12:25:11 -0400 Subject: [PATCH 5/5] Update generating-a-draft.md --- docs/Draft-Generation/generating-a-draft.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/Draft-Generation/generating-a-draft.md b/docs/Draft-Generation/generating-a-draft.md index aa5ef35..c713e62 100644 --- a/docs/Draft-Generation/generating-a-draft.md +++ b/docs/Draft-Generation/generating-a-draft.md @@ -34,7 +34,7 @@ On the second step, select the books you want translated. If the book you want t :::note -**Incremental Draft Generation:** If you select a book that is at least 12 chapters in length and contains some text already, you will see the option to select which chapters you want to draft. If you select to draft only some chapters, you will be able to choose some or all of the remaining chapters for training the model in the following step. Separate chapters with commas and use a dash for chapter ranges, as follows: 1-10,25,40-50 +**Incremental Draft Generation:** If you select a book that is at least 12 chapters in length and contains some text already, you will see the option to select which chapters you want to draft. If you select to draft only some chapters, you will be able to choose some or all of the remaining chapters for training the model in the following step. Separate chapters with commas and use a dash for chapter ranges, as follows: 1-10,25,40-50. [new screenshot needed: selecting which chapters in a book to draft] @@ -54,7 +54,7 @@ On the next step, select the books to use to train the language model, both in y :::note -If you selected to draft only some chapters of a book in the previous step, you can choose to include all or part of the remaining chapters in training. Any chapters selected to draft will not be available for training. Separate chapters with commas and use a dash for chapter ranges, as follows: 1-10,25,40-50 +If you selected to draft only some chapters of a book in the previous step, you can choose to include all or part of the remaining chapters in training. Any chapters selected to draft will not be available for training. Separate chapters with commas and use a dash for chapter ranges, as follows: 1-10,25,40-50. [new screenshot needed: selecting which chapters in a book to use for training]