Docs monitor improvements

.gitbook.yaml

@@ -0,0 +1,97 @@
+root: ./
+
+redirects:
+  build-apps/references/bns: clarity/example-contracts/bns.md
+  build-apps/references/gaia: stacks-in-depth/gaia.md/README.md
+  docs/blockchain/stacks-blockchain-api: stacks-101/api.md
+  docs/clarity: clarity/overview.md
+  docs/clarity/crash-course: clarity/clarity-crash-course.md
+  docs/clarity/language-functions: clarity/functions.md
+  docs/clarity/language-keywords: clarity/keywords.md
+  docs/clarity/language-types: clarity/types.md
+  docs/clarity/noteworthy-contracts/bns-contract: clarity/example-contracts/bns.md
+  docs/clarity/noteworthy-contracts/stacking-contract: clarity/example-contracts/stacking.md
+  docs/clarity/noteworthy-contracts/xbtc: clarity/example-contracts/xbtc.md
+  docs/clarity/sample-contracts: clarity/example-contracts/audited-starter-contracts.md
+  docs/clarity/security: clarity/decidability.md
+  docs/clarity/security/decidable: clarity/decidability.md
+  docs/contribute: stacks-101/what-is-stacks.md
+  docs/contribute/docs: stacks-101/what-is-stacks.md
+  docs/contribute/translations: stacks-101/what-is-stacks.md
+  docs/cookbook: tutorials/hello-stacks-quickstart-tutorial.md
+  docs/cookbook/creating-an-ft: tutorials/hello-stacks-quickstart-tutorial.md
+  docs/cookbook/creating-an-nft: tutorials/hello-stacks-quickstart-tutorial.md
+  docs/cookbook/get-sats-per-stx: tutorials/hello-stacks-quickstart-tutorial.md
+  docs/cookbook/parse-a-btc-tx: tutorials/hello-stacks-quickstart-tutorial.md
+  docs/cookbook/post-conditions: tutorials/hello-stacks-quickstart-tutorial.md
+  docs/cookbook/sending-bitcoin-with-hiro-wallet: tutorials/hello-stacks-quickstart-tutorial.md
+  docs/cookbook/stacks-js-auth: tutorials/hello-stacks-quickstart-tutorial.md
+  docs/cookbook/stacks-js-sending-transactions: tutorials/hello-stacks-quickstart-tutorial.md
+  docs/cookbook/verifying-a-btc-tx-was-mined: tutorials/hello-stacks-quickstart-tutorial.md
+  docs/gaia: stacks-in-depth/gaia/README.md
+  docs/gaia/configuration: stacks-in-depth/gaia/configuration.md
+  docs/gaia/deploy-gaia-hub: stacks-in-depth/gaia/deploy-gaia-hub.md
+  docs/gaia/gaia-on-ec2: stacks-in-depth/gaia/gaia-on-ec2.md
+  docs/gaia/setup-linux: stacks-in-depth/gaia/setup-linux.md
+  docs/gaia/setup-mac: stacks-in-depth/gaia/setup-mac.md
+  docs/glossary: stacks-101/what-is-stacks.md
+  docs/intro: stacks-101/what-is-stacks.md
+  docs/nakamoto: nakamoto-upgrade/what-is-the-nakamoto-release.md
+  docs/nakamoto/bitcoin-mev-mitigation: nakamoto-upgrade/nakamoto-in-10-minutes.md
+  docs/nakamoto/block-production: nakamoto-upgrade/nakamoto-in-10-minutes.md
+  docs/nakamoto/neon: nakamoto-upgrade/testnets/neon.md
+  docs/nakamoto/signer: nakamoto-upgrade/running-a-signer.md
+  docs/nakamoto/stacking: nakamoto-upgrade/stacking-flow.md
+  docs/next-steps: stacks-101/what-is-stacks.md
+  docs/nodes-and-miners: stacks-in-depth/nodes-and-miners/README.md
+  docs/nodes-and-miners/digitalocean: stacks-in-depth/nodes-and-miners/run-a-node-with-digital-ocean.md
+  docs/nodes-and-miners/hosted-nodes: stacks-in-depth/nodes-and-miners/run-a-node-with-a-hosted-provider.md
+  docs/nodes-and-miners/miner-costs-and-fees: stacks-in-depth/nodes-and-miners/miner-costs-and-fees.md
+  docs/nodes-and-miners/miner-mainnet: stacks-in-depth/nodes-and-miners/mine-mainnet-stacks-tokens.md
+  docs/nodes-and-miners/miner-testnet: stacks-in-depth/nodes-and-miners/mine-testnet-stacks-tokens.md
+  docs/nodes-and-miners/quicknode: stacks-in-depth/nodes-and-miners/run-a-node-with-quicknode.md
+  docs/nodes-and-miners/run-a-node: stacks-in-depth/nodes-and-miners/run-a-node-with-docker.md
+  docs/nodes-and-miners/stacks-node-configuration: stacks-in-depth/nodes-and-miners/stacks-node-configuration.md
+  docs/nodes-and-miners/verify-miner: stacks-in-depth/nodes-and-miners/verify-miner.md
+  docs/services-using-stacks/defi: stacks-101/what-is-stacks.md
+  docs/services-using-stacks/more: stacks-101/what-is-stacks.md
+  docs/services-using-stacks/nft: stacks-101/what-is-stacks.md
+  docs/services-using-stacks/stacks-info-sites: stacks-101/what-is-stacks.md
+  docs/services-using-stacks/wallets: stacks-101/what-is-stacks.md
+  docs/stacks-academy: stacks-101/what-is-stacks.md
+  docs/stacks-academy/accounts: stacks-101/accounts.md
+  docs/stacks-academy/authentication: stacks-101/authentication.md
+  docs/stacks-academy/bns: stacks-101/bitcoin-name-system.md
+  docs/stacks-academy/btc-connection: stacks-101/bitcoin-connection.md
+  docs/stacks-academy/microblocks: nakamoto-upgrade/nakamoto-in-depth/what-about-microblocks.md
+  docs/stacks-academy/mining: stacks-101/mining.md
+  docs/stacks-academy/network: stacks-101/network.md
+  docs/stacks-academy/post-conditions: stacks-101/post-conditions.md
+  docs/stacks-academy/proof-of-transfer: stacks-101/proof-of-transfer.md
+  docs/stacks-academy/sips: stacks-101/sips.md
+  docs/stacks-academy/stacking: stacks-101/stacking.md
+  docs/stacks-academy/stacks-blockchain-api: stacks-101/api.md
+  docs/stacks-academy/technical-specs: stacks-101/technical-specifications.md
+  docs/stacks-academy/testnet: stacks-101/testnet.md
+  docs/stacks-academy/transactions: stacks-101/transactions.md
+  docs/stacks-academy/what-is-stacks: stacks-101/what-is-stacks.md
+  docs/stacks-academy/whitepapers: stacks-101/whitepapers.md
+  docs/tutorials: tutorials/hello-stacks-quickstart-tutorial.md
+  docs/tutorials/community-tutorials: tutorials/community-tutorials.md
+  docs/tutorials/hello-stacks: tutorials/hello-stacks-quickstart-tutorial.md
+  docs/understand-stacks/testnet: stacks-101/testnet.md
+  docs/write-smart-contracts: clarity/overview.md
+  references/bns-contract: clarity/example-contracts/bns.md
+  references/language-functions: clarity/functions.md
+  understand-stacks/microblocks: nakamoto-upgrade/nakamoto-in-depth/what-about-microblocks.md
+  understand-stacks/mining: stacks-101/mining.md
+  understand-stacks/network: stacks-101/network.md
+  understand-stacks/proof-of-transfer: stacks-101/proof-of-transfer.md
+  understand-stacks/stacking: stacks-101/stacking.md
+  understand-stacks/testnet: stacks-101/testnet.md
+  understand-stacks/transactions: stacks-101/transactions.md
+  write-smart-contracts/language-functions: clarity/functions.md
+  write-smart-contracts/overview: clarity/overview.md
+  write-smart-contracts/principals: clarity/types.md
+  write-smart-contracts/tokens: tutorials/tokens.md
+  sbtc/introduction: concepts/sbtc/README.md

.gitbook/assets/_category_ (1).json

@@ -0,0 +1,9 @@
+{
+    "label": "References",
+    "position": 9,
+    "link": {
+      "type": "generated-index",
+      "description": "Stacks references."
+    }
+  }
+

.gitbook/assets/_category_ (2).json

@@ -0,0 +1,8 @@
+{
+  "label": "Noteworthy Contracts",
+  "position": 5,
+  "link": {
+    "type": "generated-index",
+    "description": "Specific deployed Clarity Contracts worth mentioning."
+  }
+}

.gitbook/assets/_category_.json

@@ -0,0 +1,9 @@
+{
+    "label": "Services using Stacks",
+    "position": 8,
+    "link": {
+      "type": "generated-index",
+      "description": "An 'always incomplete' list of services that use Stacks."
+    }
+}
+

.gitbook/assets/language functions.mdx

@@ -0,0 +1,15 @@
+---
+title: Functions
+description: See a detailed list of all functions for the Clarity language.
+sidebar_position: 3
+tags:
+  - clarity
+---
+
+import { FunctionsReferences } from "@site/src/components/ApiReferences/FunctionsReferences.jsx";
+
+## Functions
+
+Detailed list of all functions for the Clarity language.
+
+<FunctionsReferences toc={toc} />

.gitbook/assets/language keywords.mdx

@@ -0,0 +1,17 @@
+---
+title: Keywords
+description: See a detailed list of all keywords for the Clarity language.
+sidebar_position: 4
+tags:
+  - clarity
+---
+
+import { KeywordsReferences } from "@site/src/components/ApiReferences/KeywordsReferences.jsx";
+
+![Abstract image illustrate Clarity native keywords](/img/keywords.jpg)
+
+## Keyword reference
+
+Detailed list of all keywords for the Clarity language.
+
+<KeywordsReferences toc={toc} />

.gitbook/includes/note-for-existing-signersth....md

@@ -0,0 +1,45 @@
+---
+title: Note for Existing SignersTh...
+---
+
+{% hint style="info" %}
+**Note for Existing Signers**
+
+The block for Nakamoto activation has been chosen as Bitcoin block 867,867, which is currently expected on October 28th. This block is subject to change should core developers need additional time for testing or unexpected issues.
+
+The 3.0 binaries (and Docker images) are provided below. Note that if you do not upgrade ahead of the hard fork, your nodes will be dropped from the network.
+
+If you have previously been running a signer, you'll want to make sure you do the following:
+
+First, upgrade your node and signer to the latest version (listed below).
+
+For miners: If you are currently using the config value `[miner].activated_vrf_key_path`, the saved json file will need to be removed prior to restart (it will be recreated). You will also need to add a new key to the miner section:
+
+```
+[miner]
+mining_key = "private key" ## may be the same as [node].seed
+```
+
+**Important note**: Any unrecognized and uncommented config value _will_ cause the binary to panic.
+
+The output will specify which configuration key caused the panic (there may be more than one, but the message will only show the first unrecognized key) in the format:
+
+```
+$ stacks-node check-config --config ./Config.toml
+INFO [1738695683.067315] [testnet/stacks-node/src/main.rs:278] [main] stacks-node 3.1.0.0.5 (release/3.1.0.0.5:513dbc5, release build, linux [x86_64])
+INFO [1729707265.671604] [testnet/stacks-node/src/main.rs:318] [main] Loading config at path ./Config.toml
+WARN [1729707265.671992] [testnet/stacks-node/src/main.rs:325] [main] Invalid config file: Invalid toml: unknown field `foo`, expected one of `name`, `seed`, `deny_nodes`, `working_dir`, `rpc_bind`, `p2p_bind`, `p2p_address`, `data_url`, `bootstrap_node`, `local_peer_seed`, `miner`, `stacker`, `mock_mining`, `mock_mining_output_dir`, `mine_microblocks`, `microblock_frequency`, `max_microblocks`, `wait_time_for_microblocks`, `wait_time_for_blocks`, `next_initiative_delay`, `prometheus_bind`, `marf_cache_strategy`, `marf_defer_hashing`, `pox_sync_sample_secs`, `use_test_genesis_chainstate`, `always_use_affirmation_maps`, `require_affirmed_anchor_blocks`, `chain_liveness_poll_time_secs`, `stacker_dbs`, `fault_injection_block_push_fail_probability` for key `node` at line 20 column 1
+```
+
+**Changed config field**
+
+Note that in the Stacks node config file, the `block_proposal_token` field has been changed to `auth_token`.
+
+**Current Signer and Stacks Node Versions**
+
+For quick reference, here are the current latest versions you'll want to be running as a signer. If you don't yet have your signer up and running, this guide will walk you through that.
+
+* [Binaries](https://github.com/stacks-network/stacks-core/releases/latest)
+* Stacks Signer Docker Image - [3.1.0.0.5.0](https://hub.docker.com/layers/blockstack/stacks-signer/3.1.0.0.5.0/images/sha256-4f0c19225065754ed08594deb3d2c67dc1126558e9e50f8174a1bc1736fedb99)
+* Stacks Node Docker Image - [3.1.0.0.5](https://hub.docker.com/layers/blockstack/stacks-core/3.1.0.0.5/images/sha256-cf2c04b6f56d7a54c2032a13826ebb258cebe50a30b847810a279476824bd2c0)
+{% endhint %}

.github/ISSUE_TEMPLATE/add-documentation.md

@@ -0,0 +1,20 @@
+---
+name: Add documentation
+about: Use this to add new content to docs.stacks.co
+title: "[Add docs]"
+labels: documentation
+assignees: ''
+
+---
+
+*You can use the following template to add new documentation to docs.stacks.co. You can drag and drop images or screenshots if needed.*
+---
+title: Name of my new article
+description: 
+---
+
+## Section 1
+
+## Section 2
+
+### Subsection

.github/ISSUE_TEMPLATE/edit-documentation.md

@@ -0,0 +1,12 @@
+---
+name: Edit documentation
+about: Use this to make changes on already published page
+title: "[Edit docs]"
+labels: documentation
+assignees: ''
+
+---
+
+URL of the page to change:
+---
+Explain here what you would like to change.

.github/ISSUE_TEMPLATE/other-issues.md

@@ -0,0 +1,14 @@
+---
+name: Other issues
+about: Any other issue
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the issue**
+A clear and concise description of what the issue is.
+
+**Screenshots**
+If helpful, you may add screenshots to help explain your problem.

.github/labeler.yml

@@ -0,0 +1,13 @@
+# Add labels when specific files are changed
+translations:
+  - any: ['i18n/**/*']
+
+documentation:
+  - any: ['docs/**/*.md', 'docs/**/*.mdx']
+
+dependencies:
+  - 'package.json'
+  - 'package-lock-json'
+
+docusaurus-config:
+  - 'docusaurus.config.js'

.github/pull_request_template.md

@@ -0,0 +1,3 @@
+## Description
+
+Describe the changes that were made in this pull request. When possible start with the motivations behind the change.

.github/stale.yml

@@ -0,0 +1,18 @@
+# Number of days of inactivity before an issue becomes stale
+daysUntilStale: 180
+# Number of days of inactivity before a stale issue is closed
+daysUntilClose: 7
+# Issues with these labels will never be considered stale
+exemptLabels:
+  - pinned
+  - security
+# Label to use when marking an issue as stale
+staleLabel: stale
+# Comment to post when marking an issue as stale. Set to `false` to disable
+markComment: >
+  This issue has been automatically marked as stale because it has not had
+  recent activity. It will be closed if no further activity occurs. Thank you
+  for your contributions.
+# Comment to post when closing a stale issue. Set to `false` to disable
+closeComment: >
+  This issue has been automatically closed. Please reopen if needed.

.github/workflows/.markdown-link-check_config.json

@@ -0,0 +1,20 @@
+{
+    "ignorePatterns": [
+		{
+			"pattern": "^https:\/\/www\.coinbase\.com\b"
+		},
+		{
+			"pattern": "^https:\/\/www\.kraken\.com\b"
+		}
+	],
+    "replacementPatterns": [
+        {
+            "pattern": "^/",
+            "replacement": "/github/workspace/"
+        }
+    ],
+    "aliveStatusCodes": [
+        200,
+        429
+    ]
+}

.github/workflows/add-to-project.yml.draft

@@ -0,0 +1,18 @@
+name: Add issue/PR to project
+
+on:
+  issues:
+    types:
+      - opened
+  pull_request:
+    branches: [master]
+
+jobs:
+  add-to-project:
+    name: Add issue to project
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/add-to-project@main
+        with:
+          project-url: https://github.com/orgs/stacks-network/projects/56
+          github-token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/auto-approve-translations.yml

@@ -0,0 +1,13 @@
+name: Auto approve translations
+on:
+  pull_request
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+    steps:
+    - uses: hmarr/auto-approve-action@v2
+      if: github.actor == 'bot-translations'
+      with:
+        github-token: ${{ secrets.GITHUB_TOKEN }}