From b84aa5881a0d8ef21139543b7146ee0d31ebb472 Mon Sep 17 00:00:00 2001 From: rchany Date: Thu, 16 Jul 2026 14:35:26 +0100 Subject: [PATCH] =?UTF-8?q?Update=20Governance=20Concepts=20=E2=80=9Cpubli?= =?UTF-8?q?c-preview-content=E2=80=9D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/concepts/public-preview-content.md | 39 ++++++++++++------------- 1 file changed, 19 insertions(+), 20 deletions(-) diff --git a/docs/concepts/public-preview-content.md b/docs/concepts/public-preview-content.md index eaf2e1c7..f1a0d2f9 100644 --- a/docs/concepts/public-preview-content.md +++ b/docs/concepts/public-preview-content.md @@ -1,15 +1,14 @@ --- id: public-preview-content -title: "Public preview content" +title: Public preview content sidebar_label: Public preview content -description: Learn about the public preview content pattern used by the Arbitrum DAO. +description: Learn about the public preview content pattern used by the ArbitrumDAO. dao_author: symbolpunk dao_sme: symbolpunk --- - import DraftExpectationsPartial from '@site/docs/partials/_draft-expectations-partial.md'; -Every Arbitrum DAO governance document (excluding the [Constitution](../dao-constitution)) is initially published with the following "public preview" disclaimer: +Every ArbitrumDAO governance document (excluding the [Constitution](../dao-constitution)) is initially published with the following "public preview" disclaimer: @@ -17,36 +16,36 @@ This disclaimer is used to **set expectations** and to **invite feedback** from ### What types of documents does this apply to? -This pattern applies to all Arbitrum DAO governance documents that are published here on the Arbitrum DAO docs portal, excluding [The Constitution of the Arbitrum DAO](../dao-constitution.md). Examples include: +This pattern applies to all ArbitrumDAO governance documents that are published here on the ArbitrumDAO docs portal, excluding [The Constitution of the ArbitrumDAO](../dao-constitution.md). Examples include: + +* Conceptual documentation - - Conceptual documentation - - [Delegates and delegation](./delegate-delegation.md) - - [Lifecycle and anatomy of an AIP](./lifecycle-anatomy-aip-proposal.md) - - How-to documentation - - [Apply to become a delegate](../how-tos/apply-become-delegate.md) - - [Submit an AIP](../how-tos/create-submit-dao-proposal.md) + * [Delegates and delegation](./delegate-delegation.md) + * [Lifecycle and anatomy of an AIP](./lifecycle-anatomy-aip-proposal.md) +* How-to documentation + * [Apply to become a delegate](../how-tos/apply-become-delegate.md) + * [Submit an AIP](../how-tos/create-submit-dao-proposal.md) ### How do you know when a public preview document is ready to have its disclaimer lifted? In general, a document is considered validated if it's 1) frequently viewed, 2) has a low bounce rate, and 3) doesn't have any open issues on GitHub/[Discord](https://discord.gg/arbitrum). This heuristic isn't supported by precise thresholds; it's an informal and experimental process. This document will be updated if the process changes. -### Does this mechanism apply to The Constitution of the Arbitrum DAO? +### Does this mechanism apply to The Constitution of the ArbitrumDAO? -No. The private preview content pattern does **not** apply to [The Constitution of the Arbitrum DAO](../dao-constitution.md). +No. The private preview content pattern does **not** apply to [The Constitution of the ArbitrumDAO](../dao-constitution.md). ### What's the difference between a draft and a public preview? -Readers generally interpret drafts as "not ready for public consumption". Arbitrum DAO's public preview documentation is ready for public consumption with the caveat that it still needs to be measured, validated, and optimized. - -### Does this mean that the Arbitrum DAO isn't committed to its governance documentation? +Readers generally interpret drafts as "not ready for public consumption". ArbitrumDAO's public preview documentation is ready for public consumption with the caveat that it still needs to be measured, validated, and optimized. -No. The Arbitrum DAO is committed to its governance docs, just not in exactly the same way that it's committed to the Constitution: +### Does this mean that the ArbitrumDAO isn't committed to its governance documentation? - - **The Constitution** is the Arbitrum DAO's highest-order governance document. It's the only document that's subject to the formal governance proposal mechanism. In order for the Constitution to change, a proposal must be submitted to the Arbitrum DAO and approved by a majority of the Arbitrum DAO's voting power. This is a formal process that only the Arbitrum DAO can initiate and execute. - - **Other governance documents** are derived from a combination of 1) the Constitution and 2) reader feedback. These docs frequently change via traditional pull requests issued against the governance docs repository. This is an informal, continuous, iterative process that anyone can participate in. +No. The ArbitrumDAO is committed to its governance docs, just not in exactly the same way that it's committed to the Constitution: +* **The Constitution** is the ArbitrumDAO's highest-order governance document. It's the only document that's subject to the formal governance proposal mechanism. In order for the Constitution to change, a proposal must be submitted to the ArbitrumDAO and approved by a majority of the ArbitrumDAO's voting power. This is a formal process that only the ArbitrumDAO can initiate and execute. +* **Other governance documents** are derived from a combination of 1) the Constitution and 2) reader feedback. These docs frequently change via traditional pull requests issued against the governance docs repository. This is an informal, continuous, iterative process that anyone can participate in. ### Is the governance protocol itself in public preview? -No. This disclaimer applies only to the documents that display it. It doesn't apply to the protocol; it doesn't apply to the Constitution; it doesn't apply to the smart contracts; it doesn't apply to the DAO. The Arbitrum DAO's governance protocol is in production. Some of the Arbitrum DAO's governance documentation is in public preview; those docs are marked with the same `PUBLIC PREVIEW DOCUMENT` disclaimer that you see at the top of this page. \ No newline at end of file +No. This disclaimer applies only to the documents that display it. It doesn't apply to the protocol; it doesn't apply to the Constitution; it doesn't apply to the smart contracts; it doesn't apply to the DAO. The ArbitrumDAO's governance protocol is in production. Some of the ArbitrumDAO's governance documentation is in public preview; those docs are marked with the same `PUBLIC PREVIEW DOCUMENT` disclaimer that you see at the top of this page.