Skip to content

Commit 13e9ca2

Browse files
committed
1909 update documentation
1 parent a34f4d4 commit 13e9ca2

File tree

6 files changed

+72
-99
lines changed

6 files changed

+72
-99
lines changed

Readme.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,9 @@ instance fully synced to a specific network is:
2020
* Look up the balance of any stake address for any Shelley or later epoch.
2121
* Look up the amount of ADA delegated to each pool for any Shelley or later epoch.
2222

23-
Example SQL queries are available at [Example Queries][ExampleQueries]. You can also find some [DB Sync best practices here](https://docs.cardano.org/cardano-components/cardano-db-sync/best-practices).
23+
## Documentation
24+
25+
The [doc/](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/Readme.md) directory, offers essential resources for users, including guides for installation with and without Nix, configuration. Key files cover, Docker usage, PostgreSQL example queries, command-line options and database migrations. There's also a troubleshooting guide for common issues. These documents provide users with the necessary steps to effectively set up and maintain the Cardano DB Sync.
2426

2527
## Architecture
2628

doc/Readme.md

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
# Documentation Table of Contents
2+
3+
## Overview
4+
5+
This directory contains various documentation files for setting up, configuring, and running the Cardano DB Sync Node. Below is a list of available documents, ordered by their importance for users.
6+
7+
8+
1. [Installing](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/installing.md)
9+
- Steps for installing the Cardano DB Sync from source without using Nix.
10+
11+
2. [Installing with Nix](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/installing-with-nix.md)
12+
- Steps for installing Cardano DB Sync using Nix.
13+
14+
3. [Building and Running](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/building-running.md)
15+
- Instructions for setting up and running the Cardano DB Sync Node.
16+
17+
4. [Configuration](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/configuration.md)
18+
- Details on how to configure the Cardano DB Sync Node.
19+
20+
5. [Command Line Options](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/command-line-options.md)
21+
- Documentation on command-line options for the Cardano DB Sync Node.
22+
23+
6. [Running](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/running.md)
24+
- Guide to running the Cardano DB Sync Node.
25+
26+
7. [Docker](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/docker.md)
27+
- Instructions for using Docker to run the Cardano DB Sync Node.
28+
29+
8. [Upgrading PostgreSQL](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/upgrading-postgresql.md)
30+
- Guide for upgrading PostgreSQL versions for use with Cardano DB Sync.
31+
32+
9. [Validation](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/validation.md)
33+
- Information on the validation process for genesis, blocks, transactions, and runtime rewards.
34+
35+
10. [Migrations](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/migrations.md)
36+
- Details on database migrations for different versions of Cardano DB Sync.
37+
38+
11. [Schema](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/schema.md)
39+
- Overview of the database schema used by the Cardano DB Sync Node.
40+
41+
12. [Schema Management](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/schema-management.md)
42+
- Instructions on managing database schema and creating migrations.
43+
44+
13. [Syncing and Rollbacks](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/syncing-and-rollbacks.md)
45+
- Details on the syncing procedure and handling rollbacks.
46+
47+
14. [Community Tools](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/community-tools.md)
48+
- Information on various community tools like Koios and Blockfrost.
49+
50+
15. [Interesting Queries](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/interesting-queries.md)
51+
- A collection of useful SQL queries for interacting with the database.
52+
53+
16. [Troubleshooting](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/troubleshooting.md)
54+
- Common issues and troubleshooting steps for Cardano DB Sync.
55+
56+
17. [Release Process](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/release-process.md)
57+
- Detailed process for releasing new versions of Cardano DB Sync.
58+
59+
18. [State Snapshot](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/state-snapshot.md)
60+
- Guide to creating and restoring state snapshots.
61+
62+
19. [Pool OffChain Data](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/pool-offchain-data.md)
63+
- Handling off-chain data for staking pools.
64+
65+
20. [SMASH](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/smash.md)
66+
- Information on the Stakepool Metadata Aggregation Server (SMASH).
67+
68+
21. [HLint and Stylish Haskell](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/hlint-stylish-haskell.md)
69+
- Setting up `hlint` and `stylish-haskell` for code linting and formatting.
File renamed without changes.

doc/what_why_how.md

Lines changed: 0 additions & 31 deletions
This file was deleted.

docs/Makefile

Lines changed: 0 additions & 47 deletions
This file was deleted.

docs/iohk-skeleton.tex

Lines changed: 0 additions & 20 deletions
This file was deleted.

0 commit comments

Comments
 (0)