Migrate appendix and footnotes to web-accessible articles #33

New issue

Open

opened 2026-02-22 09:59:38 +00:00 by grams777 · 0 comments

grams777 commented

2026-02-22 09:59:38 +00:00

(Migrated from github.com)

Summary

Migrate the content currently in the PDF appendix, footnotes, and independent web pages to markdown articles on the website. This replaces static PDF artifacts and scattered web content with version-controlled, web-accessible articles that integrate with the existing CI/CD pipeline.

Motivation

The current appendix PDF (appendix.pdf) dates from 2018 and is a static artifact
Footnotes and translation notes are not easily discoverable or searchable
Content is scattered across independent pages on updated.org and declaring.com that should be consolidated
The website now has an article system (articles/index.php) that auto-renders markdown files
The Bible chat assistant indexes articles automatically via Gemini File Search

Benefits

Version controlled — reviewable via pull requests
Auto-rendered on the website as articles
Auto-indexed into the chat assistant (Gemini File Search)
PDFs can be generated from markdown in CI if needed
Single source of truth — no separate PDF/web/chat content to maintain

Scope

Identify all content in appendix.pdf that should become articles
Break appendix into logical article topics (translation decisions, variant notes, methodology, etc.)
Convert footnote content to article format where appropriate
Migrate relevant independent pages from updated.org into articles
Migrate relevant independent pages from declaring.com into articles
Create .md files in articles/ for each topic
Update website links that currently point to appendix.pdf or external pages
Add PDF generation to CI/CD pipeline (optional)
Remove or archive the static PDF once migration is complete

## Summary Migrate the content currently in the PDF appendix, footnotes, and independent web pages to markdown articles on the website. This replaces static PDF artifacts and scattered web content with version-controlled, web-accessible articles that integrate with the existing CI/CD pipeline. ## Motivation - The current appendix PDF (appendix.pdf) dates from 2018 and is a static artifact - Footnotes and translation notes are not easily discoverable or searchable - Content is scattered across independent pages on updated.org and declaring.com that should be consolidated - The website now has an article system (`articles/index.php`) that auto-renders markdown files - The Bible chat assistant indexes articles automatically via Gemini File Search ## Benefits - **Version controlled** — reviewable via pull requests - **Auto-rendered** on the website as articles - **Auto-indexed** into the chat assistant (Gemini File Search) - **PDFs can be generated** from markdown in CI if needed - **Single source of truth** — no separate PDF/web/chat content to maintain ## Scope - [ ] Identify all content in `appendix.pdf` that should become articles - [ ] Break appendix into logical article topics (translation decisions, variant notes, methodology, etc.) - [ ] Convert footnote content to article format where appropriate - [ ] Migrate relevant independent pages from updated.org into articles - [ ] Migrate relevant independent pages from declaring.com into articles - [ ] Create `.md` files in `articles/` for each topic - [ ] Update website links that currently point to `appendix.pdf` or external pages - [ ] Add PDF generation to CI/CD pipeline (optional) - [ ] Remove or archive the static PDF once migration is complete