docs: connect UI

[dannylwe]

Describe your changes

Issue ticket number and link

Checklist before requesting a review (skip if just adding/editing APIs & templates)

• I added tests, otherwise the reason is:
• I added observability, otherwise the reason is:
• I added analytics, otherwise the reason is:

[linear]

EXT-230 Documentation Connect UI

[khaliqgant]

This file and the others should go under trello-scim

[khaliqgant]

@dannylwe Similar to Algolia there should be a "Going further" link on the main integration page that links to the connect.mdx page

[bodinsamuel]

I have not read everything yet, looks good overall.
It's missing the most critical part though, it needs to be linked in the providers.yaml, you can follow Algolia example:

• Add docs_connect
• If present, for each connection_config add a doc_section
• For each credentials add a doc_section

Note: I haven't documented all credentials for Basic Auth, I think only Bamboo HR, freshdesh and jira were done but you get the idea.

Sorry about that, it's very recent so the process is not perfect yet 👌🏻

[bodinsamuel]

Sorry it was a left over from me, Connect UI should be named Nango Connect (or just Connect)

[TBonnin]

lgtm. I am assuming the instructions are correct.

One question though for @bastienbeurier @khaliqgant: Are we not worried about the UI of the providers changing and our guide to become obsolete eventually?

[TBonnin]

two key pieces but the list below contains 4

[TBonnin]

Suggested change

	To authenticate with Datadog, you need two key pieces of information:
	To authenticate with Datadog, you need three key pieces of information:

[TBonnin]

Suggested change

	To authenticate with Miro, you need two key pieces of information:
	To authenticate with Miro, you need one key piece of information:

[TBonnin]

Suggested change

	To authenticate with Notion, you need two key pieces of information:
	To authenticate with Notion, you need one key piece of information:

[TBonnin]

Suggested change

	To authenticate with Perimeter81, you need two key pieces of information:
	To authenticate with Perimeter81, you need one key piece of information:

[bodinsamuel]

Another comments, it would be less painful to sync with @khaliqgant before. Maybe it's okay to merge as-is and fix the rest later

[bodinsamuel]

A comment that applies for all markdown, it should be one section per entry so the doc_section is directly relevant and ordered by the field order, e.g:

• Step 1: find your node id
• Step 2: find your api key

NB: you can reorder fields based on what's more logical, here for example apiKey will be first because we put credentials first but it's more logical to put order: 1

[dannylwe]

A comment that applies for all markdown, it should be one section per entry so the doc_section is directly relevant and ordered by the field order, e.g:

Step 1: find your node id
Step 2: find your api key

this has been updated and should be in the correct order.

[bodinsamuel]

We should try to optimize the png as much as we can, apparently mintlify is not doing it by default

[bodinsamuel]

💯