Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

• Auto
• Light
• Dark

xGov Beta Architecture

The xGov Architecture source code is released on the official GitHub repository.

Issues can be submitted on the GitHub issues page.

External contributions are welcome. If you would like to contribute, please read these guidelines and consider submitting a Pull Request.

⚠️ Commits must be signed!

The xGov Architecture is implemented in Algorand Python.

Any external contributions MUST:

1. Be submitted as a Pull Request.
2. Pass the CI/CD pipeline;
3. Update the relevant documentation;
4. Be approved by the xGov Architecture maintainers.

By clicking on the “Suggest an edit” icon in the top-right corner, while reading this book, you will be redirected to the relevant documentation source code file to be referenced in an Issue or edited in a Pull Request.

The xGov Architecture Specifications book is built with mdBook.

The book is written in CommonMark.

The CI pipeline enforces Markdown linting, formatting, and style checking with markdownlint.

Numbered lists MUST be defined with 1-only style.

Tip

1. First item
1. Second item
1. Third item

Result:

1. First item
2. Second item
3. Third item

Table rows MUST use the same column widths.

Tip

✅ Correct table format

| Month    | Savings |
|----------|---------|
| January  | €250    |
| February | €80     |
| March    | €420    |

❌ Wrong table format

| Month | Savings |
|----------|---------|
| January | €250 |
| February | €80 |
| March | €420 |

Result:

Month	Savings
January	€250
February	€80
March	€420

Consider aligning text in the columns to the left, right, or center by adding a colon : to the left, right, or on both sides of the dashes --- within the header row.

Tip

| Name   | Quantity | Size |
|:-------|:--------:|-----:|
| Item A |    1     |    S |
| Item B |    5     |    M |
| Item C |    10    |   XL |

Result:

Name	Quantity	Size
Item A	1	S
Item B	5	M
Item C	10	XL

Mathematical formulas are defined with MathJax.

mdBook MathJax documentation.

Block styles are defined in the ./docs/_include/styles.md file using the mdBook include feature.

Block styles (e.g., examples, implementation notes, etc.) are “styled quote” blocks included in the book.

Tip

This example block has been included with the following syntax:

{{#include ./_include/styles.md:example}}
> This example block has been included with the following syntax: