> For the complete documentation index, see [llms.txt](https://docs.koinia.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.koinia.app/readme.md).

# koinia-docs

Source content for Koinia's documentation, synced to GitBook via Git Sync.

This is a **monorepo**: one repository that feeds **four GitBook spaces**, grouped into two bilingual sites.

```
user-guide/    Public help center for church admins & leaders
  es/          → GitBook space (Spanish, default variant)
  en/          → GitBook space (English variant)
internal/      Private knowledge base for the Koinia support team
  es/          → GitBook space (Spanish, default variant)
  en/          → GitBook space (English variant)
```

Each directory is a self-contained GitBook project: it has its own `.gitbook.yaml`, `README.md` (landing page), `SUMMARY.md` (navigation), and `assets/`.

## How the GitBook wiring works

In GitBook, connect each space to this repo and set its **Project directory** to the matching folder above (e.g. `user-guide/es`). GitBook reads `.gitbook.yaml` inside that folder.

* **Bilingual:** in each Site, add the `en` space as a variant of the `es` space (Site → Structure → Add variant). Readers switch languages with the language picker.
* **Privacy:** set the two `internal/*` spaces to private/unlisted so support runbooks are never public.
* **Theme:** brand color, logo, and fonts are configured in the GitBook app, not in this repo.

## Editing

Author Spanish (`es`) first — it is the source of truth and matches the Koinia UI, which is in Spanish. Then mirror changes into `en`. Keep file paths identical across `es` and `en` so the two variants stay structurally in sync.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.koinia.app/readme.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.