Skip to content

Commit 5871822

Browse files
evantahlerjatinyadav-cc
authored andcommitted
Support archived connectors in Docs (airbytehq#35374)
1 parent 94fc789 commit 5871822

File tree

4 files changed

+57
-19
lines changed

4 files changed

+57
-19
lines changed

docs/integrations/connector-support-levels.md

Lines changed: 35 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -12,32 +12,57 @@ The following table describes the support levels of Airbyte connectors.
1212
| **Who builds them?** | Either the community or the Airbyte team. | Typically they are built by the community. The Airbyte team may upgrade them to Certified at any time. | Anyone can build custom connectors. We recommend using our [Connector Builder](https://docs.airbyte.com/connector-development/connector-builder-ui/overview) or [Low-code CDK](https://docs.airbyte.com/connector-development/config-based/low-code-cdk-overview). |
1313
| **Who maintains them?** | The Airbyte team | Users | Users |
1414
| **Production Readiness** | Guaranteed by Airbyte | Not guaranteed | Not guaranteed |
15-
| **Support: Cloud** | Supported* | No Support | Supported** |
16-
| **Support: Powered by Airbyte** | Supported* | No Support | Supported** |
17-
| **Support: Self-Managed Enterprise** | Supported* | No Support | Supported** |
15+
| **Support: Cloud** | Supported\* | No Support | Supported\*\* |
16+
| **Support: Powered by Airbyte** | Supported\* | No Support | Supported\*\* |
17+
| **Support: Self-Managed Enterprise** | Supported\* | No Support | Supported\*\* |
1818
| **Support: Community (OSS)** | Slack Support only | No Support | Slack Support only |
1919

20-
\*For Certified connectors, Official Support SLAs are only available to customers with Premium Support included in their contract. Otherwise, please use our support portal and we will address your issues as soon as possible.
20+
\*For Certified connectors, Official Support SLAs are only available to customers with Premium
21+
Support included in their contract. Otherwise, please use our support portal and we will address
22+
your issues as soon as possible.
2123

22-
\*\*For Custom connectors, Official Support SLAs are only available to customers with Premium Support included in their contract. This support is provided with best efforts, and maintenance/upgrades are owned by the customer.
24+
\*\*For Custom connectors, Official Support SLAs are only available to customers with Premium
25+
Support included in their contract. This support is provided with best efforts, and
26+
maintenance/upgrades are owned by the customer.
2327

2428
## Certified
2529

26-
A **Certified** connector is actively maintained and supported by the Airbyte team and maintains a high quality bar. It is production ready.
30+
A **Certified** connector is actively maintained and supported by the Airbyte team and maintains a
31+
high quality bar. It is production ready.
2732

2833
### What you should know about Certified connectors:
2934

3035
- Certified connectors are available to all users.
3136
- These connectors have been tested and vetted in order to be certified and are production ready.
32-
- Certified connectors should go through minimal breaking change but in the event an upgrade is needed users will be given an adequate upgrade window.
37+
- Certified connectors should go through minimal breaking change but in the event an upgrade is
38+
needed users will be given an adequate upgrade window.
3339

3440
## Community
3541

36-
A **Community** connector is maintained by the Airbyte community until it becomes Certified. Airbyte has over 800 code contributors and 15,000 people in the Slack community to help. The Airbyte team is continually certifying Community connectors as usage grows. As these connectors are not maintained by Airbyte, we do not offer support SLAs around them, and we encourage caution when using them in production.
42+
A **Community** connector is maintained by the Airbyte community until it becomes Certified. Airbyte
43+
has over 800 code contributors and 15,000 people in the Slack community to help. The Airbyte team is
44+
continually certifying Community connectors as usage grows. As these connectors are not maintained
45+
by Airbyte, we do not offer support SLAs around them, and we encourage caution when using them in
46+
production.
3747

3848
### What you should know about Community connectors:
3949

4050
- Community connectors are available to all users.
41-
- Community connectors may be upgraded to Certified at any time, and we will notify users of these upgrades via our Slack Community and in our Connector Catalog.
42-
- Community connectors might not be feature-complete (features planned for release are under development or not prioritized) and may include backward-incompatible/breaking API changes with no or short notice.
51+
- Community connectors may be upgraded to Certified at any time, and we will notify users of these
52+
upgrades via our Slack Community and in our Connector Catalog.
53+
- Community connectors might not be feature-complete (features planned for release are under
54+
development or not prioritized) and may include backward-incompatible/breaking API changes with no
55+
or short notice.
4356
- Community connectors have no Support SLAs.
57+
58+
## Archived
59+
60+
From time to time, Airbyte will remove a connector from the Connector Catalog. This is typically due
61+
extremely low usage and/or if the connector is no longer maintained by the community. This is
62+
necessary to ensure that the Connector Catalog maintains a minimum level of quality.
63+
64+
Archived connectors will not receive any further updates or support from the Airbyte team. Archived
65+
connectors remain source-available in the
66+
[`airbytehq/connector-archive`](https://github.com/airbytehq/connector-archive) repository on
67+
GitHub. If you wish to take over the maintenance of an archived connector, please open a Github
68+
Discussion.

docusaurus/src/components/ConnectorRegistry.jsx

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,10 +19,12 @@ Sorts connectors by release stage and then name
1919
*/
2020
function connectorSort(a, b) {
2121
if (a.supportLevel_oss !== b.supportLevel_oss) {
22-
if (a.supportLevel_oss === "certified") return -2;
23-
if (b.supportLevel_oss === "certified") return 2;
24-
if (a.supportLevel_oss === "community") return -1;
25-
if (b.supportLevel_oss === "community") return 1;
22+
if (a.supportLevel_oss === "certified") return -3;
23+
if (b.supportLevel_oss === "certified") return 3;
24+
if (a.supportLevel_oss === "community") return -2;
25+
if (b.supportLevel_oss === "community") return 2;
26+
if (a.supportLevel_oss === "archived") return -1;
27+
if (b.supportLevel_oss === "archived") return 1;
2628
}
2729

2830
if (a.name_oss < b.name_oss) return -1;

docusaurus/src/components/HeaderDecoration.jsx

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,7 @@ export const HeaderDecoration = ({
3838
const isOss = isOssString.toUpperCase() === "TRUE";
3939
const isCloud = isCloudString.toUpperCase() === "TRUE";
4040
const isPypiPublished = isPypiPublishedString.toUpperCase() === "TRUE";
41+
const isArchived = supportLevel.toUpperCase() === "ARCHIVED";
4142

4243
return (
4344
<>
@@ -51,13 +52,17 @@ export const HeaderDecoration = ({
5152
<span className={isOss ? styles.available : styles.unavailable}>
5253
{isOss ? CHECK_ICON : CROSS_ICON} Airbyte OSS
5354
</span>
54-
{isPypiPublished && <a href="#usage-with-airbyte-lib" className={styles.available}>{CHECK_ICON} airbyte_lib</a>}
55+
{isPypiPublished && (
56+
<a href="#usage-with-airbyte-lib" className={styles.available}>
57+
{CHECK_ICON} airbyte_lib
58+
</a>
59+
)}
5560
</dd>
5661
</div>
5762
<div>
5863
<dt>Support Level</dt>
5964
<dd>
60-
<a href="/project-overview/product-support-levels/">
65+
<a href="/integrations/connector-support-levels/">
6166
{capitalizeFirstLetter(supportLevel)}
6267
</a>
6368
</dd>
@@ -74,9 +79,16 @@ export const HeaderDecoration = ({
7479

7580
<div className={styles.header}>
7681
<img src={iconUrl} alt="" className={styles.connectorIcon} />
77-
<h1 id={originalId}>{originalTitle}</h1>
82+
<h1 id={originalId}>
83+
{isArchived ? (
84+
<span>
85+
{originalTitle} <span style={{ color: "red" }}>[ARCHIVED]</span>
86+
</span>
87+
) : (
88+
originalTitle
89+
)}
90+
</h1>
7891
</div>
7992
</>
8093
);
8194
};
82-

docusaurus/src/remark/docsHeaderDecoration.js

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,4 @@
11
const visit = require("unist-util-visit").visit;
2-
const { isPypiConnector } = require("../connector_registry");
32
const { isDocsPage, getRegistryEntry } = require("./utils");
43

54
const toAttributes = (props) =>

0 commit comments

Comments
 (0)