FAQ docs quality pass: fix broken links, mismatched H1s, orphaned phrasing

[lyzhang0113]

Summary

Repo-wide quality pass over the FAQ docs (excluding barcode-reader/web/debug/debug-mode.md, already fixed in #28), covering license/, mrz-scanner/, and all of barcode-reader/ (general, mobile, server, web). For each file, checked and fixed where confidently identifiable:

• Missing/mismatched H1s (should match the link text used for that page in its directory's index.md)
• Redundant/duplicate sections covering the same ground
• Orphaned Q&A-snippet phrasing (e.g. "Yes —" or "this can be expanded" with no visible question/antecedent)
• Broken internal links, most caused by the mobile/web directory reorgs (old flat paths pointing at files that moved into configuration/, capabilities/, debug/, scan-setting/, simulator/, or archive/)
• Broken image references

No technical facts, code samples, or archived version-pinned content (-v9.6.40, -v10.4.2000, etc.) were changed — those directories were reviewed for structural/reference issues only, not modernized. */archive/* content was instead excluded from the Jekyll build entirely (originally #55, now merged directly into this branch), since none of it was linked from any live index or hosted on the site.

Also added along the way: README.md is now a plain contributor README (was a Jekyll page duplicating the homepage, unlinked from anywhere) and is excluded from the build; FAQ article-authoring conventions (frontmatter, H1 rules, linking, archive-directory rules) moved into a new AGENTS.md for agents/contributors writing new articles.

Follow-up issues (to be fixed directly on this branch)

Everything below needs a human decision or fact-check rather than a mechanical fix. Filed as separate issues so they can be worked one at a time:

• C++ sample in ensure-no-overuse.md uses undeclared variable and wrong call order #31 — C++ sample in ensure-no-overuse.md uses undeclared variable and wrong call order
• Python sample in enable-supported-barcode-format.md has stray double-space #32 — Python sample in enable-supported-barcode-format.md has stray double-space
• performance-optimization.md contradicts itself on enableMultiFrameCrossFilter default #33 — performance-optimization.md contradicts itself on enableMultiFrameCrossFilter default
• check-current-version.md: npm version-check command is wrong (en dash + wrong command) #34 — check-current-version.md: npm version-check command is wrong (en dash + wrong command)
• check-current-version.md: Java sample missing 'new' when constructing BarcodeReaderModule #35 — check-current-version.md: Java sample missing 'new' when constructing BarcodeReaderModule
• check-camera.md index link text doesn't match its actual content #43 — check-camera.md index link text doesn't match its actual content
• ways-to-copy-dbr-js-deployable-files.md is an orphaned page not linked from any index #44 — ways-to-copy-dbr-js-deployable-files.md is an orphaned page not linked from any index
• ways-to-copy-dbr-js-deployable-files.md: numbered list broken by headings mid-list #45 — ways-to-copy-dbr-js-deployable-files.md: numbered list broken by headings mid-list
• is-https-required.md: frontmatter title says 'HTTPs', H1 says 'HTTPS' #46 — is-https-required.md: frontmatter title says 'HTTPs', H1 says 'HTTPS'
• change-domain-binding-of-product-key.md: H1 doesn't match index link text or frontmatter title #47 — change-domain-binding-of-product-key.md: H1 doesn't match index link text or frontmatter title
• formats-supported-for-existing-files.md: likely typo '.icon' should be '.ico' #48 — formats-supported-for-existing-files.md: likely typo '.icon' should be '.ico'
• pop-up-window-during-trail-process.md: filename typo, 'trail' should be 'trial' #49 — pop-up-window-during-trail-process.md: filename typo, 'trail' should be 'trial'
• Stray '<< Back to FAQ index' links missed by a prior cleanup #50 — Stray '<< Back to FAQ index' links missed by a prior cleanup
• license-barcode-format-discrepancies.md is an orphaned page not linked from any index #51 — license-barcode-format-discrepancies.md is an orphaned page not linked from any index
• difference-between-bestspeed-and-bestcoverage.md: index link text uses stale v9-era terminology #52 — difference-between-bestspeed-and-bestcoverage.md: index link text uses stale v9-era terminology
• README.md is an unlinked duplicate of the homepage, not excluded from the site build #53 — README.md is an unlinked duplicate of the homepage, not excluded from the site build
• search.md sidebar setting inconsistent with index.md/README.md #54 — search.md sidebar setting inconsistent with index.md/README.md

Archived-content issues

These were all filed against content under */archive/*. Rather than fixing broken links/stranded content in place, the decision was to exclude those directories from the Jekyll build entirely, since nothing in them is linked from any live index or hosted on the site (originally PR #55, now merged and folded directly into this branch's history):

• Archived Android v10.4.2000 index has ~12 broken links from the mobile docs reorg #36, Archived iOS v10.4.2000 index has ~12 broken links from the mobile docs reorg #37, Broken links to nonexistent api-reference/samples directories in iOS archive pages #38, Possibly stranded/duplicate content in mobile/archive/ios (bitcode-support.md, template-support.md) #39, Unrecognized Liquid variable {{ site.android_api }} in reduce-battery-consumption-v9.6.40.md #40 — already closed as won't-fix (wontfix label) — the pages they were filed against are excluded from the build, so their broken links/stranded content have no user-facing impact
• server/configuration/index.md: Aztec-code archive entry may not belong in server FAQ #41 — fixed (duplicate archive file + index entry removed) — still open pending this PR merging to preview
• Filename typo: onUnduplicateRead should be onUniqueRead #42 — closed as won't-fix — unlinked from its index; not worth renaming now that it's unlinked archived content

Test plan

• Spot-check a sample of the changed pages render correctly (headings, links, images)
• Confirm no build/link-checker regressions from the internal link fixes

🤖 Generated with Claude Code