update repository references in mkdocs configuration and add disclaimer to documentation

Author: portuu3

.github/workflows/cd-gitbook-sdk-docs.yaml

@@ -1,7 +1,7 @@
 site_name: HUMAN Protocol Python SDK Docs
 site_url: https://sdk.humanprotocol.org/python/
-repo_name: humanprotocol/human-protocol-sdk
-repo_url: https://github.com/humanprotocol/human-protocol-sdk
+repo_name: humanprotocol/human-protocol
+repo_url: https://github.com/humanprotocol/human-protocol
 docs_dir: ../packages/sdk/python/human-protocol-sdk/docs
 site_dir: python
 theme:

docs/mkdocs-python.yaml

@@ -1,7 +1,7 @@
 site_name: HUMAN Protocol TypeScript SDK Docs
 site_url: https://sdk.humanprotocol.org/ts/
-repo_name: humanprotocol/human-protocol-sdk
-repo_url: https://github.com/humanprotocol/human-protocol-sdk
+repo_name: humanprotocol/human-protocol
+repo_url: https://github.com/humanprotocol/human-protocol
 docs_dir: ../packages/sdk/typescript/human-protocol-sdk/docs
 site_dir: ts
 theme:

docs/mkdocs-ts.yaml

@@ -257,3 +257,23 @@ h1, h2, h3, h4, h5, h6 {
   color: var(--md-primary-fg-color);
   font-weight: 700;
 }
+
+/* Disclaimer bar */
+.md-disclaimer {
+  background: rgb(212, 207, 255);
+  color: var(--md-primary-fg-color);
+  border-bottom: 1px solid rgba(99, 9, 255, 0.25);
+  padding: 0.1rem 0;
+}
+
+.md-disclaimer p {
+  margin: 0;
+  font-size: 0.6rem;
+  text-align: center;
+}
+
+.md-disclaimer__link {
+  font-weight: 550;
+  color: rgb(99, 9, 255);
+  text-decoration: underline;
+}

docs/overrides/assets/css/custom.css

@@ -111,6 +111,15 @@
   {% endif %}
 </header>
 
+  <div class="md-disclaimer">
+    <div class="md-grid">
+      <p>
+        The new styling applies starting with version 5.2.0. For earlier versions, visit
+        <a href="https://legacy-sdk.humanprotocol.org" class="md-disclaimer__link">legacy-sdk.humanprotocol.org</a>.
+      </p>
+    </div>
+  </div>
+
 <script>
   (function () {
     function updateLangSwitch() {

docs/overrides/partials/header.html

@@ -14,6 +14,9 @@ HUMAN Protocol is a decentralized infrastructure for coordinating human work at
 - **Statistics**: Access protocol-wide metrics and analytics
 - **Encryption**: Secure message encryption using PGP for private communications
 
+!!! info "Subgraph access and rate limits"
+    The SDK calls public subgraph endpoints by default. Unauthenticated requests are rate-limited and may return errors. For higher limits, use your own [API key](https://thegraph.com/docs/it/subgraphs/querying/managing-api-keys/).
+
 ## Key Features
 
 ### Smart Contract Interactions

packages/sdk/python/human-protocol-sdk/docs/index.md

@@ -14,6 +14,9 @@ HUMAN Protocol is a decentralized infrastructure for coordinating human work at
 - **Statistics**: Access protocol-wide metrics and analytics
 - **Encryption**: Secure message encryption using PGP for private communications
 
+!!! info "Subgraph access and rate limits"
+    The SDK calls public subgraph endpoints by default. Unauthenticated requests are rate-limited and may return errors. For higher limits, use your own [API key](https://thegraph.com/docs/it/subgraphs/querying/managing-api-keys/).
+
 ## Key Features
 
 ### Smart Contract Clients
@@ -64,6 +67,9 @@ npm install @human-protocol/sdk
 yarn add @human-protocol/sdk
 ```
 
+!!! warning "Keep ethers in sync"
+    The SDK is built against a specific `ethers` major/minor (currently `6.15.x`). Pin the same major/minor in your app. Mixing different minors (e.g., `6.16.x` with the SDK) can trigger errors.
+
 ## Quick Start
 
 ### Read-Only Operations