Skip to content

Get started

Who to ask, where to look

2 min readUpdated

Page actions

ChatGPT and Claude are third-party services. The link gives them this page's public address and a short instruction. This site records nothing.

Where questions, bugs, feature ideas, scripture-fidelity concerns, security reports and design decisions each go, and who reviews what.

I want to…Go to
understand why something is the way it isthe ADRs — every decision that shaped the project, with its context and consequences
find the rule for a change I am makingEngineering invariants first; then the glossary for a term
report a bug in the site, the API or a toola bug report
propose a featurea feature request
say that a verse, heading, numeral or Ang looks wronga scripture fidelity concern — never a code change; it is routed to a Granthi or scholar
report a security problememail support@gurbanisoul.com (SECURITY); never a public issue
ask how to do something in this repositoryopen a discussion on the pull request or issue you are working on; the owner reads every one
change how we work (branching, gates, tooling)propose an ADR in a pull request (docs/adr/NNNN-title.md, status proposed)

Who reviews what

Every change is reviewed by the code owner (.github/CODEOWNERS). Some paths are listed there explicitly because a mistake in them reaches the scripture or the apps: the dataset pin (dataset.lock.json), the golden contract (contract/), the Roman fold (webapp/romannorm.py), the verifier (webapp/verify.py) and the CI configuration (.github/). Expect a slower, closer review on those.

Scripture questions are not answered by engineers. The project keeps a scholar review for anything that changes how the text is extracted, displayed or explained; the answer protocol in sggs-data says how a quotation may be shown and how explanation must be labelled.

Company and product names

The company is Algorythmos Pty Ltd; the app is Gurbani Soul; the website and this wiki are the Sri Guru Granth Sahib Ji — Knowledge Base. The scripture is always cited as Sri Guru Granth Sahib Ji · Ang N; “Gurbani Soul” names the app, never the text. Brand & domains has the rest.