garage/doc/book/src/SUMMARY.md

# Summary

[The Garage Data Store](./intro.md)

- [Quick start](./quick_start/index.md)

- [Cookbook](./cookbook/index.md)
  - [Multi-node deployment](./cookbook/real_world.md)
  - [Building from source](./cookbook/from_source.md)
  - [Integration with systemd](./cookbook/systemd.md)
  - [Gateways](./cookbook/gateways.md)
  - [Exposing buckets as websites](./cookbook/exposing_websites.md)
  - [Configuring a reverse proxy](./cookbook/reverse_proxy.md)
  - [Recovering from failures](./cookbook/recovering.md)

- [Integrations](./connect/index.md)
  - [Apps (Nextcloud, Peertube...)](./connect/apps.md)
  - [Websites (Hugo, Jekyll, Publii...)](./connect/websites.md)
  - [Repositories (Docker, Nix, Git...)](./connect/repositories.md)
  - [CLI tools (rclone, awscli, mc...)](./connect/cli.md)
  - [Backups (restic, duplicity...)](./connect/backup.md)
  - [Your code (PHP, JS, Go...)](./connect/code.md)
  - [FUSE (s3fs, goofys, s3backer...)](./connect/fs.md)


- [Reference Manual](./reference_manual/index.md)
  - [Garage configuration file](./reference_manual/configuration.md)
  - [Cluster layout management](./reference_manual/layout.md)
  - [Garage CLI](./reference_manual/cli.md)
  - [S3 compatibility status](./reference_manual/s3_compatibility.md)

- [Design](./design/index.md)
  - [Related Work](./design/related_work.md)
  - [Internals](./design/internals.md)
  - [Design draft](./design/design_draft.md)

- [Development](./development/index.md)
  - [Setup your environment](./development/devenv.md)
  - [Development scripts](./development/scripts.md)
  - [Release process](./development/release_process.md)
  - [Miscellaneous notes](./development/miscellaneous_notes.md)

- [Working Documents](./working_documents/index.md)
  - [Load Balancing Data](./working_documents/load_balancing.md)
  - [Migrating from 0.3 to 0.4](./working_documents/migration_04.md)
Doc skeleton + intro 2021-03-17 13:44:14 +00:00			`# Summary`

			`[The Garage Data Store](./intro.md)`

Reorganize documentation 2021-05-31 15:13:36 +00:00			`- [Quick start](./quick_start/index.md)`
Doc skeleton + intro 2021-03-17 13:44:14 +00:00
Refactor file organization 2021-03-17 15:15:18 +00:00			`- [Cookbook](./cookbook/index.md)`
Improve how node roles are assigned in Garage - change the terminology: the network configuration becomes the role table, the configuration of a nodes becomes a node's role - the modification of the role table takes place in two steps: first, changes are staged in a CRDT data structure. Then, once the user is happy with the changes, they can commit them all at once (or revert them). - update documentation - fix tests - implement smarter partition assignation algorithm This patch breaks the format of the network configuration: when migrating, the cluster will be in a state where no roles are assigned. All roles must be re-assigned and commited at once. This migration should not pose an issue. 2021-11-09 11:24:04 +00:00			`- [Multi-node deployment](./cookbook/real_world.md)`
Reorganize documentation 2021-05-31 15:13:36 +00:00			`- [Building from source](./cookbook/from_source.md)`
Add doc for Nextcloud 2021-10-29 16:05:47 +00:00			`- [Integration with systemd](./cookbook/systemd.md)`
Add documentation about Gateways 2021-11-04 14:25:20 +00:00			`- [Gateways](./cookbook/gateways.md)`
Documentation for hugo, jekyll and publii 2021-11-04 09:51:15 +00:00			`- [Exposing buckets as websites](./cookbook/exposing_websites.md)`
Doc about exposing your website 2021-11-04 11:06:38 +00:00			`- [Configuring a reverse proxy](./cookbook/reverse_proxy.md)`
Add doc for Nextcloud 2021-10-29 16:05:47 +00:00			`- [Recovering from failures](./cookbook/recovering.md)`

			`- [Integrations](./connect/index.md)`
			`- [Apps (Nextcloud, Peertube...)](./connect/apps.md)`
			`- [Websites (Hugo, Jekyll, Publii...)](./connect/websites.md)`
Documentation for Nix binary cache 2021-11-10 09:01:48 +00:00			`- [Repositories (Docker, Nix, Git...)](./connect/repositories.md)`
Add doc for Nextcloud 2021-10-29 16:05:47 +00:00			`- [CLI tools (rclone, awscli, mc...)](./connect/cli.md)`
Add skeleton for backups, fuse and code sections 2021-11-10 17:05:07 +00:00			`- [Backups (restic, duplicity...)](./connect/backup.md)`
Add doc for Nextcloud 2021-10-29 16:05:47 +00:00			`- [Your code (PHP, JS, Go...)](./connect/code.md)`
Add skeleton for backups, fuse and code sections 2021-11-10 17:05:07 +00:00			`- [FUSE (s3fs, goofys, s3backer...)](./connect/fs.md)`
Add doc for Nextcloud 2021-10-29 16:05:47 +00:00
Work on structure + Getting started is reworked 2021-03-17 14:44:29 +00:00
Refactor file organization 2021-03-17 15:15:18 +00:00			`- [Reference Manual](./reference_manual/index.md)`
Write documentation on configuration file and other improvements 2021-05-28 16:00:59 +00:00			`- [Garage configuration file](./reference_manual/configuration.md)`
Improve how node roles are assigned in Garage - change the terminology: the network configuration becomes the role table, the configuration of a nodes becomes a node's role - the modification of the role table takes place in two steps: first, changes are staged in a CRDT data structure. Then, once the user is happy with the changes, they can commit them all at once (or revert them). - update documentation - fix tests - implement smarter partition assignation algorithm This patch breaks the format of the network configuration: when migrating, the cluster will be in a state where no roles are assigned. All roles must be re-assigned and commited at once. This migration should not pose an issue. 2021-11-09 11:24:04 +00:00			`- [Cluster layout management](./reference_manual/layout.md)`
Write documentation on configuration file and other improvements 2021-05-28 16:00:59 +00:00			`- [Garage CLI](./reference_manual/cli.md)`
Updates to documentation 2021-05-31 15:23:35 +00:00			`- [S3 compatibility status](./reference_manual/s3_compatibility.md)`
Work on structure + Getting started is reworked 2021-03-17 14:44:29 +00:00
Refactor file organization 2021-03-17 15:15:18 +00:00			`- [Design](./design/index.md)`
			`- [Related Work](./design/related_work.md)`
			`- [Internals](./design/internals.md)`
Move design draft to separate file; write about GC in internals 2021-11-08 15:03:15 +00:00			`- [Design draft](./design/design_draft.md)`
Work on structure + Getting started is reworked 2021-03-17 14:44:29 +00:00
Refactor file organization 2021-03-17 15:15:18 +00:00			`- [Development](./development/index.md)`
			`- [Setup your environment](./development/devenv.md)`
Build Garage with Nix 2021-10-04 16:27:57 +00:00			`- [Development scripts](./development/scripts.md)`
			`- [Release process](./development/release_process.md)`
Documentation for Nix binary cache 2021-11-10 09:01:48 +00:00			`- [Miscellaneous notes](./development/miscellaneous_notes.md)`
Refactor file organization 2021-03-17 15:15:18 +00:00
			`- [Working Documents](./working_documents/index.md)`
			`- [Load Balancing Data](./working_documents/load_balancing.md)`
Improve CLI, adapt tests, update documentation 2021-10-19 14:16:10 +00:00			`- [Migrating from 0.3 to 0.4](./working_documents/migration_04.md)`