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

# README

This is the source for the Decentral documentation site, published at [docs.usedecentral.org](https://docs.usedecentral.org). It is built with Jekyll using the [Just the Docs](https://just-the-docs.com) theme.

## Structure

```
docs/
  index.md                   # Homepage / project overview
  quickstart.md              # Getting started guide
  architecture.md            # System architecture overview
  beta.md                    # Beta program info
  changelog.md               # Version history
  core-concepts/             # How jobs, credits, settlement, and privacy work
  api-reference/             # REST API endpoints
  providers/                 # Running a worker node, staking, reputation
  integrations/              # SDKs and OpenAI-compatible usage
  _config.yml                # Jekyll + Just the Docs config
```

## Running locally

You will need Ruby and Bundler installed.

```bash
bundle install
bundle exec jekyll serve
```

The site will be available at `http://localhost:4000`.

If you do not have a `Gemfile` yet, create one with:

```ruby
source "https://rubygems.org"
gem "github-pages", group: :jekyll_plugins
gem "jekyll-remote-theme"
```

## Contributing

Pages are plain Markdown with Jekyll front matter. Each file starts with something like:

```yaml
---
layout: default
title: Page Title
nav_order: 5
parent: Parent Section
---
```

`nav_order` controls the sidebar position. `parent` scopes the page under a section.

Keep content factual and concise. Avoid reproducing information that belongs in the code or the API itself. If something is likely to change, link to the source rather than duplicating it here.

When adding a new section, add an `index.md` for the section landing page and set `has_children: true` in its front matter so the sidebar nests correctly.

## Deployment

The site deploys automatically to GitHub Pages on every push to `main`. No build step is required locally beyond verifying it renders correctly.


---

# 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.usedecentral.org/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.
