Divine Discourses

Toward direct engagement with the Qur'an

Contribute

This project needs careful work, not money. Every path below ends in a public record: an issue anyone can read, a change anyone can audit, a name in the credits.

Report a correction

The fastest contribution there is. Every page footer has a Report a correction form that sends straight to the maintainer, or open a correction issue on GitHub. Something that blocks you from using the site at all has its own accessibility-barrier issue. Corrections are logged publicly on the Changelog, which you can follow by feed.

Propose a structural reading

The heart of the project. Pick a surah, propose where its discourse pivots, and back each division with evidence from the site's own open data. The Read page's discovery worksheet (Study depth) walks you through it and its Submit button opens the structural-hypothesis issue with your worksheet filled in. Your reading must be your own, never a reproduction of a copyrighted outline; the full rules, a worked example, and the review checklist are in CONTRIBUTING.md.

Twenty-nine of the thirty surahs Dr. Khan published outlines for still need transcription: the open queue lives on Coverage, one claimable surah at a time.

Translate

The interface is English-only today, and the plan for an Arabic-first orientation page is written and waiting on one thing: a translator. If you write clear Arabic, Urdu, Bengali, French, Spanish, Malay, or Indonesian, open an issue saying which language you can carry and the maintainer will share the worklist. Scholarly terms stay as they are; this is interface and orientation text.

Review and verify

The site's whole method is checkable claims, and checking them is a contribution. The Validation page's triangulation prompts are self-contained verification exercises; a confirmation or a discrepancy are equally valuable. For a focused review of a claim, method, source, or framing, open a scholarly-review issue and show your evidence and working. Use a correction issue when you already know a specific published claim is wrong.

Ground rules

Conduct: CODE_OF_CONDUCT.md (argue from evidence; respect the text, its readers, and the scholarship). Security reports: SECURITY.md. Code and data changes travel as pull requests against the repository; questions and ideas that are not yet a correction fit an open issue. Contributors are credited on Credits.