Skip to content

Commit

Permalink
feat(docs): New docs format (#3118)
Browse files Browse the repository at this point in the history
<!-- Describe the problem and your solution --> 
Updates our docs for integrations to be in the new format described in
[the
ticket](https://linear.app/nango/issue/NAN-2320/backfill-api-specific-docs
).

We're leaning on Mintlify snippets for the always generated portions of
the document. See `scripts/docs-gen-snippets.mjs` for that.

<!-- Issue ticket number and link (if applicable) -->

https://linear.app/nango/issue/NAN-2320/backfill-api-specific-docs

<!-- Testing instructions (skip if just adding/editing providers) -->

## How I tested it
- Run `npm run docs`
- Click through the updated documents and make sure everything looks
right

---------

Co-authored-by: Bastien Beurier <bastienbeurier@gmail.com>
  • Loading branch information
nalanj and bastienbeurier authored Dec 12, 2024
1 parent ef33847 commit a3035df
Show file tree
Hide file tree
Showing 615 changed files with 28,295 additions and 3,650 deletions.
82 changes: 70 additions & 12 deletions docs-v2/integrations/all/accelo.mdx
Original file line number Diff line number Diff line change
@@ -1,29 +1,87 @@
---
title: Accelo
sidebarTitle: Accelo
provider: accelo
---

API configuration: [`accelo`](https://nango.dev/providers.yaml)
import Overview from "/snippets/overview.mdx";

## Features
import PreBuiltUseCases from "/snippets/generated/accelo/PreBuiltUseCases.mdx"

| Features | Status |
<Overview />

## Pre-built tooling

<AccordionGroup>
<Accordion title="✅ Authorization">
| Tools | Status |
| - | - |
| Pre-built authorization (OAuth) ||
| Credentials auto-refresh ||
| Auth parameters validation | Not needed |
| Credentials validation | Not needed for OAuth |
| Pre-built Connect UI ||
| Custom authorization UI ||
| End-user authorization guide | Not needed for OAuth |
| Expired credentials detection ||
</Accordion>
<Accordion title="✅ Read & write data">
| Tools | Status |
| - | - |
| Pre-built use-cases | 🚫 (time to contribute: &lt;48h)]) |
| API unification ||
| 2-way sync ||
| Webhooks from Nango on data modifications ||
| Real-time webhooks from 3rd-party API ||
| Proxy requests ||
</Accordion>
<Accordion title="✅ Observability & data quality">
| Tools | Status |
| - | - |
| [Auth (OAuth)](/guides/getting-started/authorize-an-api-from-your-app) ||
| [Sync data](/guides/getting-started/read-from-an-api) ||
| [Perform workflows](/guides/getting-started/write-to-an-api) ||
| [Proxy requests](/guides/proxy-requests-to-an-api) ||
| [Receive webhooks](/guides/receive-webhooks-from-an-api) | 🚫 (time to contribute: &lt;48h) |
| HTTP request logging ||
| End-to-type type safety ||
| Data runtime validation ||
| OpenTelemetry export ||
| Slack alerts on errors ||
| Integration status API ||
</Accordion>
<Accordion title="✅ Customization">
| Tools | Status |
| - | - |
| Create or customize use-cases ||
| Pre-configured pagination ||
| Pre-configured rate-limit handling ||
| Per-customer configurations ||
</Accordion>
</AccordionGroup>

<PreBuiltUseCases />

## Access requirements
| Pre-Requisites | Status | Comment|
| - | - | - |
| Paid dev account || |
| Paid test account || |
| Partnership || |
| App review || |
| Security audit || |

<Tip>We can implement missing features in &lt;48h, just ask for it in the [community](https://nango.dev/slack).</Tip>
## Setup guide

## Getting started
_No setup guide yet._

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

<Note>Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/accelo.mdx)</Note>


## Useful links

- [How to register an Application](https://api.accelo.com/docs/#registering-your-application)
- [OAuth-related docs](https://api.accelo.com/docs/#authentication)
- [List of OAuth scopes](https://api.accelo.com/docs/#scope)

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>
<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/accelo.mdx)</Note>

## Connection configuration in Nango

Expand All @@ -41,4 +99,4 @@ For more details, see the [docs here](/guides/getting-started/authorize-an-api-f

_None yet, add yours!_

<Note>Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/accelo.mdx)</Note>
<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/accelo.mdx)</Note>
82 changes: 70 additions & 12 deletions docs-v2/integrations/all/acuity-scheduling.mdx
Original file line number Diff line number Diff line change
@@ -1,32 +1,90 @@
---
title: Acuity Scheduling
sidebarTitle: Acuity Scheduling
provider: acuity-scheduling
---
import Overview from "/snippets/overview.mdx";

API configuration: [`acuity-scheduling`](https://nango.dev/providers.yaml)
import PreBuiltUseCases from "/snippets/generated/acuity-scheduling/PreBuiltUseCases.mdx"

## Features
<Overview />

| Features | Status |
## Pre-built tooling

<AccordionGroup>
<Accordion title="✅ Authorization">
| Tools | Status |
| - | - |
| Pre-built authorization (OAuth) ||
| Credentials auto-refresh ||
| Auth parameters validation | Not needed |
| Credentials validation | Not needed for OAuth |
| Pre-built Connect UI ||
| Custom authorization UI ||
| End-user authorization guide | Not needed for OAuth |
| Expired credentials detection ||
</Accordion>
<Accordion title="✅ Read & write data">
| Tools | Status |
| - | - |
| Pre-built use-cases | 🚫 (time to contribute: &lt;48h)]) |
| API unification ||
| 2-way sync ||
| Webhooks from Nango on data modifications ||
| Real-time webhooks from 3rd-party API ||
| Proxy requests ||
</Accordion>
<Accordion title="✅ Observability & data quality">
| Tools | Status |
| - | - |
| HTTP request logging ||
| End-to-type type safety ||
| Data runtime validation ||
| OpenTelemetry export ||
| Slack alerts on errors ||
| Integration status API ||
</Accordion>
<Accordion title="✅ Customization">
| Tools | Status |
| - | - |
| [Auth (OAuth)](/guides/getting-started/authorize-an-api-from-your-app) ||
| [Sync data](/guides/getting-started/read-from-an-api) ||
| [Perform workflows](/guides/getting-started/write-to-an-api) ||
| [Proxy requests](/guides/proxy-requests-to-an-api) ||
| [Receive webhooks](/guides/receive-webhooks-from-an-api) | 🚫 (time to contribute: &lt;48h) |
| Create or customize use-cases ||
| Pre-configured pagination ||
| Pre-configured rate-limit handling ||
| Per-customer configurations ||
</Accordion>
</AccordionGroup>

<PreBuiltUseCases />

## Access requirements
| Pre-Requisites | Status | Comment|
| - | - | - |
| Paid dev account || |
| Paid test account || |
| Partnership || |
| App review || |
| Security audit || |


<Tip>We can implement missing features in &lt;48h, just ask for it in the [community](https://nango.dev/slack).</Tip>
## Setup guide

## Getting started
_No setup guide yet._

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

<Note>Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/acuity-scheduling.mdx)</Note>


## Useful links

- [How to register an Application](https://acuityscheduling.com/oauth2/register)
- [OAuth-related docs](https://developers.acuityscheduling.com/docs/oauth2)
- [API](https://developers.acuityscheduling.com/reference/quick-start)

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>
<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/acuity-scheduling.mdx)</Note>

## API gotchas
- Acuity uses OAuth for authentication. Ensure you have the correct client ID and secret.
- Acuity Scheduling enforces a general rate limit of 10 requests a second and 20 concurrent connections from an IP.

<Note>Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/acuity-scheduling.mdx)</Note>
<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/acuity-scheduling.mdx)</Note>
85 changes: 72 additions & 13 deletions docs-v2/integrations/all/adobe.mdx
Original file line number Diff line number Diff line change
@@ -1,23 +1,82 @@
---
title: Adobe
sidebarTitle: Adobe
provider: adobe
---

API configuration: [`adobe`](https://nango.dev/providers.yaml),[`adobe-umapi`](https://nango.dev/providers.yaml) for Adobe user management API
import Overview from "/snippets/overview.mdx";

## Features
import PreBuiltUseCases from "/snippets/generated/adobe/PreBuiltUseCases.mdx"

| Features | Status |
<Overview />

## Pre-built tooling

<AccordionGroup>
<Accordion title="✅ Authorization">
| Tools | Status |
| - | - |
| Pre-built authorization (OAuth) ||
| Credentials auto-refresh ||
| Auth parameters validation | Not needed |
| Credentials validation | Not needed for OAuth |
| Pre-built Connect UI ||
| Custom authorization UI ||
| End-user authorization guide | Not needed for OAuth |
| Expired credentials detection ||
</Accordion>
<Accordion title="✅ Read & write data">
| Tools | Status |
| - | - |
| Pre-built use-cases | 🚫 (time to contribute: &lt;48h)]) |
| API unification ||
| 2-way sync ||
| Webhooks from Nango on data modifications ||
| Real-time webhooks from 3rd-party API ||
| Proxy requests ||
</Accordion>
<Accordion title="✅ Observability & data quality">
| Tools | Status |
| - | - |
| [Auth (OAuth)](/guides/getting-started/authorize-an-api-from-your-app) ||
| [Sync data](/guides/getting-started/read-from-an-api) ||
| [Perform workflows](/guides/getting-started/write-to-an-api) ||
| [Proxy requests](/guides/proxy-requests-to-an-api) ||
| [Receive webhooks](/guides/receive-webhooks-from-an-api) | 🚫 (time to contribute: &lt;48h) |
| HTTP request logging ||
| End-to-type type safety ||
| Data runtime validation ||
| OpenTelemetry export ||
| Slack alerts on errors ||
| Integration status API ||
</Accordion>
<Accordion title="✅ Customization">
| Tools | Status |
| - | - |
| Create or customize use-cases ||
| Pre-configured pagination ||
| Pre-configured rate-limit handling ||
| Per-customer configurations ||
</Accordion>
</AccordionGroup>

<PreBuiltUseCases />

## Access requirements
| Pre-Requisites | Status | Comment|
| - | - | - |
| Paid dev account || |
| Paid test account || |
| Partnership || |
| App review || |
| Security audit || |

<Tip>We can implement missing features in &lt;48h, just ask for it in the [community](https://nango.dev/slack).</Tip>

## Getting started
## Setup guide

_No setup guide yet._

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

<Note>Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/adobe.mdx)</Note>


## Useful links

- [How to register an Application](https://developer.adobe.com/developer-console/docs/guides/getting-started)
- [OAuth-related docs](https://developer.adobe.com/developer-console/docs/guides/authentication/OAuth)
Expand All @@ -26,7 +85,7 @@ API configuration: [`adobe`](https://nango.dev/providers.yaml),[`adobe-umapi`](h
- [UMAPI authentication](https://adobe-apiplatform.github.io/umapi-documentation/en/UM_Authentication.html)
- [UMAPI API docs](https://adobe-apiplatform.github.io/umapi-documentation/en/RefOverview.html)

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>
<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/adobe.mdx)</Note>

## API gotchas

Expand All @@ -38,8 +97,8 @@ API configuration: [`adobe`](https://nango.dev/providers.yaml),[`adobe-umapi`](h
- UMAPI is only available to the [enterprise plan](https://community.adobe.com/t5/enterprise-teams-discussions/is-the-user-management-api-available-only-for-enterprise-customers/td-p/12159610)
- UMAPI enforces API rate limiting, please refer to the Throttling section of each API to determine its limitations. e.g, [Throttling](https://adobe-apiplatform.github.io/umapi-documentation/en/api/getUsersREST.html#getUsersRESTThrottle) for the Get All Users in Organization API.

<Note>Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/adobe.mdx)</Note>
<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/adobe.mdx)</Note>

<Card title="Connect to UMAPI (Adobe User Management API)" icon="link" href="/integrations/all/adobe-umapi/connect" horizontal>
Guide to connect to UMAPI (Adobe User Management API) using Connect UI
</Card>
</Card>
Loading

0 comments on commit a3035df

Please sign in to comment.