feat: update stale docs (upstash#2307)

Author: enesgules

docs/adding-libraries.mdx

@@ -32,7 +32,7 @@ The fastest way to add a library is through our web interface:
 3. Submit and let Context7 parse and index the documentation.
 
 <Note>
-  For private repositories, see the [Private Repositories](/howto/private-repositories) guide.
+  For private sources, see the [Private Sources](/howto/private-sources) guide.
   Requires a Pro or Enterprise plan.
 </Note>
 

docs/docs.json

@@ -44,7 +44,7 @@
           "howto/claiming-libraries",
           "howto/chat-widget",
           "howto/verification",
-          "howto/private-repositories",
+          "howto/private-sources",
           "howto/teamspace",
           "howto/usage"
         ]
@@ -139,6 +139,7 @@
       {
         "group": "Integrations",
         "pages": [
+          "integrations/github-actions",
           "integrations/code-rabbit"
         ]
       },

docs/howto/chat-widget.mdx

@@ -9,6 +9,8 @@ The widget is a lightweight JavaScript snippet that renders a floating chat butt
 
 <Note>The chat widget is available to library owners who have [claimed their library](/howto/claiming-libraries).</Note>
 
+![Chat widget panel showing AI-powered documentation assistant](/images/dashboard/chat-widget.png)
+
 ## How It Works
 
 1. A visitor clicks the chat bubble on your site

docs/howto/private-repositories.mdx

@@ -0,0 +1,82 @@
+---
+title: Add Private Sources
+description: Add and manage private source documentation
+---
+
+Add private sources to Context7 to make your internal documentation available to AI coding assistants. You can add sources from GitHub, GitLab, Bitbucket, other Git providers, Confluence, and OpenAPI specifications.
+
+![Private Sources card showing a table of added sources and source type options](/images/dashboard/private-sources-card.png)
+
+## Adding Private Sources
+
+Follow these steps to add a private source:
+
+1. Go to your teamspace's **Sources** tab
+2. **Click "Add another"** to open the source type selector
+3. **Select a source type**:
+   - **GitHub** — connect your GitHub account and select a repository
+   - **GitLab** — connect your GitLab account and select a project
+   - **Bitbucket** — connect your Bitbucket account and select a repository
+   - **Other Git** — add any Git repository by URL
+   - **Confluence** — connect your Confluence workspace
+   - **OpenAPI** — add an OpenAPI specification
+4. **Authorize** Context7 to access your source (if required)
+5. **Submit** for parsing
+
+<Note>You must have a Pro or Enterprise plan to add private sources. Public sources can be added from the [Add Library](https://context7.com/add-library) page.</Note>
+
+## Source Management
+
+### Refreshing Documentation
+
+Keep your private documentation up to date:
+
+1. **Click the refresh icon** next to the source
+2. Context7 re-parses the source
+3. **You're only charged for changed content** — cached pages are free
+
+**When to refresh**:
+
+- After major documentation updates
+- After releasing new features
+- When you notice outdated information
+
+<Tip>Refresh private sources only after significant documentation changes to minimize costs.</Tip>
+
+### Removing Sources
+
+To remove a private source:
+
+1. **Click the trash icon** next to the source
+2. **Confirm deletion** in the modal
+3. Source documentation becomes unavailable immediately
+
+<Warning>
+  This action is permanent. The source will no longer be accessible via the API.
+</Warning>
+
+## Permissions
+
+Access to private source management is restricted by role. Only Owners and Admins can add, refresh, or remove private sources. Developers can view source documentation but cannot manage sources.
+
+See [Teamspace Management](/howto/teamspace#roles) for the complete permissions table.
+
+## Configuration
+
+### Using `context7.json`
+
+Add a `context7.json` file to your repository root for better control over parsing:
+
+```json
+{
+  "$schema": "https://context7.com/schema/context7.json",
+  "projectTitle": "Your Project Name",
+  "description": "Brief description of your project",
+  "folders": ["docs", "guides"],
+  "excludeFolders": ["tests", "dist", "node_modules"],
+  "excludeFiles": ["CHANGELOG.md"],
+  "rules": ["Always validate user input", "Use TypeScript strict mode"]
+}
+```
+
+See the [Adding Libraries](/adding-libraries) page for complete configuration options.

docs/howto/private-sources.mdx

@@ -42,7 +42,7 @@ Add team members, assign roles, and manage access to your Context7 dashboard fro
 
 If you are the owner of the teamspace, you can rename or delete the teamspace under the overview tab.
 
-![Teamspace management card](/images/dashboard/team-management-card.png)
+![Teamspace management card](/images/dashboard/teamspace-management.png)
 
 <Warning>Deleting a teamspace is permanent. All members lose access immediately.</Warning>
 

docs/howto/teamspace.mdx

@@ -3,59 +3,35 @@ title: Monitor Usage
 description: Monitor your Context7 API usage and track costs
 ---
 
-Track your Context7 usage with real-time metrics from the Overview tab.
+Track your Context7 usage with real-time metrics from the **Overview** tab on your teamspace dashboard.
 
-![Usage statistics card showing metrics and cost breakdown](/images/dashboard/usage-stats.png)
+![Usage statistics card showing requests, parsing tokens, seats, and cost breakdown](/images/dashboard/usage-stats.png)
 
 ## Metrics Overview
 
-Context7 tracks four key metrics to help you understand your usage patterns:
+The Overview tab displays four metrics:
 
-### Search & Query Requests
+### Requests
 
-The total number of API calls made to Context7:
-
-- **Search Requests**: Library search queries
-- **Query Requests**: Documentation retrieval calls
-
-### Query Tokens
-
-The total number of tokens returned in API responses. This reflects how much documentation content you've retrieved.
-
-<Tip>Search requests, Query requests, and Query tokens do not affect cost.</Tip>
+The total number of API calls made to Context7, shown against your plan's included quota. Requests within your quota are free; excess requests are billed based on your plan.
 
 ### Parsing Tokens
 
-The total tokens processed when parsing private repository documentation (Pro and Enterprise only).
-
-**How it works**:
+The total tokens processed when parsing private source documentation (Pro and Enterprise only).
 
-- Charged when adding a new private repository
+- Charged when adding a new private source
 - Charged for changed content when refreshing
 - No charge for cached content when refreshing
 
-**Cost**: $25 per 1M tokens
-
-### Total Cost
-
-Your monthly cost in USD (Pro and Enterprise only).
-
-**Calculation**:
-
-```
-Total Cost = Parsing Cost + Teamspace Cost
+### Seats
 
-Parsing Cost = (Parsing Tokens / 1,000,000) × $25
-Teamspace Cost = Number of Members × $7
-```
+The number of members in your teamspace. Each seat is billed monthly based on your plan.
 
-**Example**:
+### Cost
 
-- Teamspace: 4 members
-- Parsing: 800K tokens this month
-- Cost: (800K / 1M × $25) + (4 × $7) = $20 + $28 = **$48**
+Your total monthly cost in USD, with a breakdown of each component: request overages, parsing tokens, and seats.
 
-Hover over the Total Cost to see the detailed breakdown.
+See [Plans & Pricing](https://context7.com/plans) for current rates and included quotas.
 
 ## Reporting Periods