Skip to content

Explain Incremental Draft Generation - #62

Open
bhartmoore wants to merge 7 commits into
masterfrom
IDG_update
Open

Explain Incremental Draft Generation#62
bhartmoore wants to merge 7 commits into
masterfrom
IDG_update

Conversation

@bhartmoore

Copy link
Copy Markdown
Collaborator

No description provided.

@github-actions

Copy link
Copy Markdown
Contributor

🚀 Preview deployed!

You can preview this PR at: https://pr-62--sf-help-preview.netlify.app

@Nateowami

Copy link
Copy Markdown
Collaborator

@bhartmoore

Devin Review pointed out that the NT draft generation guidance document still says incremental draft generation is only available via EITL:

docs/Draft-Generation/generating-a-draft.md:R45

Linked guidance contradicts this workflow

The linked guide says self-service incremental drafting is unavailable and must not be used. Readers receive mutually exclusive instructions for the same workflow.

When I asked for details it wrote the following:

The contradiction: the new :::tip in docs/Draft-Generation/generating-a-draft.md:45 tells readers to self-serve incremental drafting — "generating a new incremental draft each time 8-10 more chapters are complete" — and links to the NT drafting guide as support. But that linked guide explicitly says incremental drafting is not self-service and must go through the EITL team:

  • docs/new-testament-drafting.md:94: "Incremental Draft Generation is not yet available as a self-service Scripture Forge feature, and must be requested through the Scripture Forge EITL team."
  • docs/new-testament-drafting.md:307-310 (FAQ): "Q: I'm ready for an incremental draft... Can I use Scripture Forge self-service draft generation to do that? A: Always request incremental drafts from the EITL team.... Scripture Forge self-service drafting currently does not support generating incremental drafts. If you are using Incremental Draft Generation to translate a book, you should not use Scripture Forge self-service draft generation to draft that same book."
  • docs/new-testament-drafting.md:86, :308 reinforce that the EITL team generates the incremental draft of remaining chapters.

So the two documents give mutually exclusive instructions:

  • docs/Draft-Generation/generating-a-draft.md:35-47 documents a new self-service chapter-selection UI and calls it "Incremental Draft Generation," telling users to do it themselves.
  • docs/new-testament-drafting.md:94,307-310 says that exact-named feature is not self-service and users should not use self-service drafting for a book they're incrementally drafting.

A reader who follows the :::tip's link lands on guidance directly telling them not to do what the tip just instructed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants