From aae9eb8473bd4be363ceee450211db5209595535 Mon Sep 17 00:00:00 2001 From: Bethany Moore Date: Wed, 19 Aug 2026 14:56:44 -0400 Subject: [PATCH 1/3] Update faq.md to address truncation --- docs/faq.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/faq.md b/docs/faq.md index c421182..26c28a8 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -73,3 +73,6 @@ slug: /faq _When you make changes to your draft, Scripture Forge saves a version of those changes that you may access via the history tab. You may revert your project to an older version from here by clicking the "Restore this version" button._ +6. Why is my book introduction cut short? + + _Scripture Forge uses the NLLB model to generate drafts. NLLB is a sentence model, and it is most accurate with short segments of text. To maximize accuracy, there is a limit of 200 tokens (word parts) per translated segment, and any text after that point is cut off. Scripture verses are translated one-by-one and very rarely exceed this limit. Paragraph-length book introductions that are longer than the allowed length will be cut off short, and only the first portion will be translated._ From a24d6b8926102a7d73030a92a25b036d922210e2 Mon Sep 17 00:00:00 2001 From: Bethany Moore Date: Wed, 2 Sep 2026 11:53:46 -0400 Subject: [PATCH 2/3] Update understanding-drafts.md Add tip on possible truncation of verse ranges --- docs/Draft-Generation/understanding-drafts.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/Draft-Generation/understanding-drafts.md b/docs/Draft-Generation/understanding-drafts.md index 77a2ea5..63b81e5 100644 --- a/docs/Draft-Generation/understanding-drafts.md +++ b/docs/Draft-Generation/understanding-drafts.md @@ -27,6 +27,12 @@ The most important point to remember is that these sentences need to say the sam Text that is available in both the language you are translating from, and the language you are translating to, is known as “parallel text”. In general, the more parallel text you have, the better the system will learn the language. For most projects, this parallel text will be your reference text, and the translation work you have already completed. At this time, we recommend that you have at least the New Testament translated. +:::tip + +Because it works at the sentence level, the translation model limits the length of sentences to be drafted. This length is different for different languages because it depends on how the model breaks apart the words. Standard Bible verses should be safe to use, as well as occasional short verse ranges. However, long ranges in the draft source text combining multiple verses or long passages like a book introduction may be cut short and not translated in full. + +::: + ## Example use cases {#937c1db4b24d4e85bfc2acc489bf456b} ### A basic example {#9165ff8c10564a7fa67c3375f62de85e} From 5dc09dd4a34ced041a16836677e6c4885cd647b5 Mon Sep 17 00:00:00 2001 From: Bethany Moore Date: Wed, 2 Sep 2026 13:14:29 -0400 Subject: [PATCH 3/3] Update understanding-drafts.md Remove recommendation to complete NT before drafting, clarify tip wording --- docs/Draft-Generation/understanding-drafts.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/Draft-Generation/understanding-drafts.md b/docs/Draft-Generation/understanding-drafts.md index 63b81e5..f3394f3 100644 --- a/docs/Draft-Generation/understanding-drafts.md +++ b/docs/Draft-Generation/understanding-drafts.md @@ -25,11 +25,11 @@ The system learns by seeing the same sentence written in multiple languages, one The most important point to remember is that these sentences need to say the same thing in both languages. This is the same principle that allowed scholars to learn hieroglyphics from the Rosetta Stone: the same text was written in three different languages, allowing comparison between a language that was already understood and one that was not. -Text that is available in both the language you are translating from, and the language you are translating to, is known as “parallel text”. In general, the more parallel text you have, the better the system will learn the language. For most projects, this parallel text will be your reference text, and the translation work you have already completed. At this time, we recommend that you have at least the New Testament translated. +Text that is available in both the language you are translating from, and the language you are translating to, is known as “parallel text”. For most projects, this parallel text will be your reference text, and the translation work you have already completed. In general, the more parallel text you have, the better the system will learn the language. If you plan to use draft generation with fewer than 6000 completed verses, please review the [Guidelines for New Testament Draft Generation](https://help.scriptureforge.org/new-testament-drafting). :::tip -Because it works at the sentence level, the translation model limits the length of sentences to be drafted. This length is different for different languages because it depends on how the model breaks apart the words. Standard Bible verses should be safe to use, as well as occasional short verse ranges. However, long ranges in the draft source text combining multiple verses or long passages like a book introduction may be cut short and not translated in full. +Because it works at the sentence level, the translation model limits the length of sentences to be drafted. This length is different for different languages because the model handles the words differently. Single Bible verses will not be affected, and most short verse ranges are safe to use. However, long ranges in the source text combining multiple verses may be cut short and not drafted in full. Long passages like book introductions may also be affected. :::