Skip to content

Commit

Permalink
No commit message
Browse files Browse the repository at this point in the history
  • Loading branch information
symbolpunk committed Sep 14, 2023
1 parent 7589273 commit f4b64ae
Show file tree
Hide file tree
Showing 5 changed files with 212 additions and 247 deletions.
51 changes: 26 additions & 25 deletions arbitrum-docs/for-devs/third-party-docs/contribute.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,28 +9,29 @@ import PublicPreviewBannerPartial from '../../partials/_public-preview-banner-pa

**Third-party docs** are documents that help readers of Arbitrum docs use other products, services, and protocols (like the ones listed in the [Arbitrum portal](https://portal.arbitrum.io/)) with Arbitrum products.

These documents are usually authored by partner teams, but can be authored by anyone. They follow the same general process that [core docs](/for-devs/contribute#add-a-new-core-document) follow, embedded here for convenience:

---

import ContributeCoreDocsPartial from '../../partials/_contribute-core-docs-partial.md';

<ContributeCoreDocsPartial />

---

<br />

Third-party docs contributors are asked to follow these guidelines as well (in addition to the above):

import ContributeThirdPartyDocsPartial from '../../partials/_contribute-third-party-docs-partial.md';

<ContributeThirdPartyDocsPartial />

<br />

---

import ContributeDocsConventionsFaqsPartial from '../../partials/_contribute-docs-conventions-faqs-partial.md';

<ContributeDocsConventionsFaqsPartial />
These documents are usually authored by partner teams, but can be authored by anyone. They follow the same general process that [core docs](/for-devs/contribute#add-a-new-core-document) follow, in addition to the following guidelines:

1. **Eligibility**
- Third-party docs are intended to support products listed in the [Arbitrum portal](https://portal.arbitrum.io/), or infrastructure and services that those products use.
- To submit your project to the Arbitrum portal, [apply using this Google form](https://docs.google.com/forms/d/e/1FAIpQLSezhBlPgKIKKWgXKUz4MmlJPdHyfmPQlxUtS48HlRoi0e14_Q/viewform).
2. **Purpose**
- The purpose of our `Third-party docs` sections is to **_meet Arbitrum developer (or user) demand for guidance that helps them use non-Arbitrum products with Arbitrum products_**.
- It's _not_ meant to drive traffic to your product (although that may happen); it's meant to solve problems that our readers are actually facing, which are directly related to Arbitrum products.
3. **Maintenance expectations**
- Offchain Labs can't commit to maintaining third-party docs, but we make it easy for you to maintain them.
- Ensure that your document's YAML frontmatter contains a `third_party_content_owner` property, with the Github username of the designated maintainer. This person will be assigned to your document's issues and PRs, and will be expected to resolve them in a timely manner.
4. **Organization**
- Third-party docs are organized within the `Third-party content` node located at the bottom of each documentation section's sidebar.
- This node's content is grouped by third-party product. If/when this becomes unwieldy, we'll begin grouping products by [portal](https://portal.arbitrum.io/) category.
5. **Limited document types**
- To manage our team's limited capacity, third-party documents must be either **_Quickstarts_**, **_How-tos_**, or **_Concepts_**. See [document types](/for-devs/contribute#document-type-conventions).
6. **Incremental contributions: One document at a time, procedures first**
- Third-party document PRs should contain at most one new document.
- Any given product's first docs contribution should be a **_Quickstart_** or **_How-to_**.
- Additional documents will be merged only if we can verify that our readers are deriving value from your initial contribution.
- The way that we verify this isn't yet formally established, and it isn't publicly disclosed. Our current approach combines a number of objective and subjective measures.
7. **Policy acknowledgment**
- Before merging third-party documentation PRs, we ask contributors to acknowledge that they've read, understood, and agree with the following policies:
1. **Content ownership**: As the author, you retain ownership of and responsibility for the content you contribute. You're free to use your content in any way you see fit outside of Arbitrum's docs. Remember that when contributing content to our documentation, you must ensure you have the necessary rights to do so, and that the content doesn't infringe on the intellectual property rights of others.
2. **License for use**: By contributing your content to our documentation, you grant Offchain Labs a non-exclusive, royalty-free license to use, reproduce, adapt, translate, distribute, and display the content in our documentation. This allows us to integrate your content into our docs and make it available to all users.
3. **Right to modify or remove**: Offchain Labs reserves the right to modify or remove third-party content from our documentation at any time. This might be necessary due to a range of reasons, such as content becoming outdated, receiving very low pageviews over an extended period, or misalignment with our guidelines or goals.
13 changes: 0 additions & 13 deletions arbitrum-docs/partials/_contribute-core-docs-partial.md

This file was deleted.

174 changes: 0 additions & 174 deletions arbitrum-docs/partials/_contribute-docs-conventions-faqs-partial.md

This file was deleted.

Loading

0 comments on commit f4b64ae

Please sign in to comment.