diff --git a/CONVENTIONS.md b/CONVENTIONS.md index 3a6f311..60cbfa1 100644 --- a/CONVENTIONS.md +++ b/CONVENTIONS.md @@ -2,6 +2,8 @@ LibreBible is the public Bible and study-resource data project. This technical repo, `libre-bible-data`, is the canonical source, normalization, and packaging repository for free-to-use Bible and Bible-study resources used by Libre Study, GracePress Bible Tooltip, and related projects. +Libre Study, LibreBible tooling, generated catalog code, and ChristIT-authored metadata are intended to be free to use, open source, free to own, and free to reuse. Third-party Bible texts and study resources may have narrower terms. When a resource is not public domain or open licensed, catalogs and manifests must describe it as a licensed/free-to-use resource and must preserve its redistribution, attribution, trademark, noncommercial, quotation, and app-linking requirements. + ## Repository Purpose This repo should gather every Bible translation and study resource that we can legally redistribute and normalize into app-ready packages. @@ -52,6 +54,7 @@ git@git.christit.com:libre-study/libre-bible-data.git ## Legal Boundary - "Free online" is not enough. Redistribution and format conversion must be allowed. +- The software/tooling can be open source even when a bundled third-party text is only free-to-use under specific terms. - Every committed text/resource package must have explicit license metadata. - If redistribution is unclear, store source metadata and importer instructions only. Do not commit the resource content. - Preserve upstream attribution and license notes in generated catalogs. diff --git a/ROADMAP.md b/ROADMAP.md index 65a5ef9..46baec2 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -149,7 +149,38 @@ Definition of done: - Libre Study can install/update a Bible package from the public catalog. - GracePress Bible Tooltip can consume the same resource metadata and package outputs. -## Phase 6: Updates, Releases, and Automation +## Phase 6: Study Modes and Canon Profiles + +Goal: let users study from a chosen tradition, canon, or research profile without hardcoding one Protestant/KJV-centered shape into the app. + +Study modes should be neutral resource bundles. A mode may define preferred translations, canon/book coverage, notes, commentaries, dictionaries, maps, timelines, and warnings about resource scope or licensing. Modes should not imply endorsement; they are study lenses. + +Possible study modes: + +- Protestant / evangelical / Baptist-oriented 66-book study. +- Catholic study with deuterocanonical books and Catholic-approved translations/resources where redistribution permits. +- Eastern Orthodox study modes where suitable translations and canon metadata are available. +- Ethiopian Orthodox study with broader canon metadata and resource discovery. +- Coptic Orthodox study mode where suitable canon/resource data is available. +- Research modes for movements or sects such as Latter-day Saint, Jehovah's Witness, Branhamite, or other historically significant groups, with explicit source attribution and clear separation from standard Bible translations. + +Tasks: + +- Add a `canon_profile` or `study_mode` metadata shape that can group translations and attachments without duplicating resources. +- Record canon/book lists per profile instead of assuming every Bible is 66 books. +- Allow resources to declare whether they are translation-specific, canon-profile-specific, denomination-specific, or translation-agnostic. +- Keep commentaries, dictionaries, maps, and general reference works translation-agnostic unless the source says otherwise. +- Keep translation footnotes, translator notes, study notes, Strong's links, morphology, and embedded cross-references tied to the translation/package that produced them. +- Add catalog fields so Libre Study can show available modes and explain what resources are included. +- Treat sect/movement modes as research profiles with careful naming, source context, and no implicit doctrinal endorsement. + +Definition of done: + +- LibreBible can describe at least one 66-book Protestant profile and one broader-canon profile. +- Libre Study can switch a session into a profile and show which translations/resources are active because of that profile. +- Resource metadata clearly distinguishes translation-specific attachments from reusable reference resources. + +## Phase 7: Updates, Releases, and Automation Goal: keep upstream scanning and package publishing repeatable. @@ -166,7 +197,7 @@ Definition of done: - A resource update can be checked, reviewed, regenerated, committed, pushed, and published without manual file hunting. -## Phase 7: Public Site Polish +## Phase 8: Public Site Polish Goal: make the public LibreBible catalog feel like a real product. @@ -190,3 +221,4 @@ Definition of done: - Whether to eventually split especially large or independently maintained translations/resources into separate repos. - Which public package format should become the preferred app install format: JSONL bundle, SQLite bundle, zip package, or another signed manifest format. - How much Gitea itself should be customized after the ChristIT.com catalog proves the model. +- How to name and present denomination, tradition, canon, and sect/movement research profiles in a way that is useful, accurate, and not confused with endorsement. diff --git a/package-lock.json b/package-lock.json index 2634773..b805529 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "libre-bible-data", - "version": "0.1.8", + "version": "0.1.9", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "libre-bible-data", - "version": "0.1.8", + "version": "0.1.9", "dependencies": { "adm-zip": "^0.5.16" } diff --git a/package.json b/package.json index fe4112d..2fac580 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "libre-bible-data", - "version": "0.1.8", + "version": "0.1.9", "private": true, "type": "module", "scripts": {