# Documenting with GitBook

We use [Gitbook](https://github.com/ampersandtarski/the-tools-we-use-for-ampersand/tree/a690f2c93b3d3ecc88047fcec3a63a82eb93e2a9/www.gitbook.com) for the following purposes:

1. to maintain documentation that changes continuously as a team, without having too much work on the coordination of this collaboration;
2. to get good looking documentation with little effort;
3. to maintain the documentation on the internet, so we can hyperlink to it from anywhere.

The documentation you are reading at this very moment is created using GitBook. It allows to write the documentation in [Markdown](https://www.gitbook.com/book/gitbookio/markdown/details), which is an easy to use document-format.

The documentation can be changed by the [gitbook-editors of Ampersand](https://app.gitbook.com/@ampersandtarski/teams). For helping to document Ampersand, please request an authorization for Gitbook with [an administrator or owner](https://app.gitbook.com/@ampersandtarski/teams). 

The documentation is organized as a book. We prefer this over a traditional wiki, because a book contains a content part, which helps both author as well as the reader to think about structure, so everything can easily be found. Each book can be served as a (part of a) website, as well be downloaded in several forms, like pdf or e-book. We use a fully automated toolchain to build the book for each commit to the master branch of a book.

At AmpersandTarski, we currently have two repositories, each dedicated to the documentation for a specific audience:

1. The repository [AmpersandTarski/TheToolsWeUse](https://github.com/AmpersandTarski/TheToolsWeUse) contains the contents of the book you are currently reading. You probably found it [here](https://www.gitbook.com/book/ampersandtarski/the-tools-we-use-for-ampersand/details). This document is not about Ampersand, but about the way Ampersand is being developed
2. The repository [AmpersandTarski/documentation](https://github.com/AmpersandTarski/documentation) is going to contain the documentation about Ampersand itself. 


---

# Agent Instructions: 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:

```
GET https://ampersandtarski.gitbook.io/the-tools-we-use-for-ampersand/gitbook.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.