Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[2024 Q4 Audit] builders/chain-operators/architecture.mdx #918

Open
7 tasks
sbvegan opened this issue Sep 24, 2024 · 0 comments
Open
7 tasks

[2024 Q4 Audit] builders/chain-operators/architecture.mdx #918

sbvegan opened this issue Sep 24, 2024 · 0 comments
Labels
a-critical needs a lot of work docs-audit-2024-Q4 OP Labs documentation audit op-labs Generally assigned for OP Labs employees. Please ask before you take on this issue. p-critical Tasks that have immediate deadlines or significant consequences if not completed on time. s-L (several weeks) Complex tasks that require significant time investment and coordination across teams

Comments

@sbvegan
Copy link
Collaborator

sbvegan commented Sep 24, 2024

Description of the updates required

This page needs to be updated to reflect what a sample production architecture page should look like. This page should:

  • add the missing components: op-conductor, op-challenger, bootnodes, ethereum L1 nodes
  • add additional links for context on each of the components
  • have emphasis that this is a focus on offchain components
  • information about how to properly peer the consensus layer
  • information about how to properly peer the execution layer
  • information on how the sequencer is isolated from the internet but peered to replicas and has a shared mempool
  • updated diagrams to reflect the architecture

Github issue label criteria

Choose the appropriate github issue labels for each page.

Priority
  • p-on-hold: (Defer) Tasks that are currently not actionable due to various reasons like waiting for external inputs, dependencies, or resource constraints. These are reviewed periodically to decide if they can be moved to a more active status.
  • p-low: (Nice to do) Tasks that have minimal impact on core operations and no immediate deadlines. These tasks are often more about quality of life improvements rather than essential needs.
  • p-medium: (Could do) Tasks that need to be done but are less critical than high-priority tasks. These often improve processes or efficiency but can be postponed if necessary without immediate severe repercussions.
  • p-high: (Should do) Important tasks that contribute significantly to long-term goals but may not have an immediate deadline. Delaying these tasks could have considerable negative effects but are not as immediate as critical tasks.
  • p-critical: Tasks that have immediate deadlines or significant consequences if not completed on time. These are non-negotiable and often linked to core business functions or legal requirements.
T-shirt size
  • s-XS: (< 1 day) Very simple tasks that require minimal time and effort.
  • s-S: (few days) Tasks that are straightforward but require a bit more time to complete.
  • s-M: (1-2 weeks) Tasks that involve a moderate level of complexity and collaboration.
  • s-L: (several weeks) Complex tasks that require significant time investment and coordination across multiple teams.
  • s-XL: (> 1 month) Very large and complex projects that involve extensive planning, execution, and testing.
Content evaluation - `a-delete`: don't need this page - `a-duplicate`: some content lives elsewhere - `a-minor`: needs small revisions - `a-moderate`: needs moderate revisions - `a-critical`: needs a lot of work

MDX Metadata format

We will be adding better metadata to the header of each page.
If I was actively searching for this page on google and this description was the search result, would I know it's the correct page?
Parse the component and feature tags to add.

tags: ["op-node", "op-geth", "batcher", "op-proposer", "op-challenger", "op-proposer", "eng-platforms",  "eng-protocol"]
---
title: "Your Title Here"
tags: ["tag1", "tag2"]
description: "A short description of the content."
---
Component tags
op-node
op-geth
op-reth
op-erigon
op-nethermind
batcher
standard-bridge
sequencer
l1-contracts
l2-contracts
precompiles
predeploys
preinstalls
op-proposer
op-challenger
op-gov-token
op-supervisor
op-conductor
fp-contracts
cannon
op-program
asterisc
kona
superchain-registry
supersim
dev-console
opsm
mcp
mcp-l2
deputy-guardian
liveness-guard
dispute-mon
op-beat
op-signer
monitorism
blockspace-charters
op-workbench
kubernetes-infrastructure
devops-tooling
artifacts-packaging
sequencer-in-a-box
devnets
op-supervisor
performance-tooling
peer-management-service
proxyd
zdd-service
snapman
security-tools
superchain-ops
op-deployer
Engineering tags
eng-platforms
eng-growth
eng-devx
eng-protocol
eng-proofs
eng-evm
eng-security
@sbvegan sbvegan added docs-audit-2024-Q4 OP Labs documentation audit op-labs Generally assigned for OP Labs employees. Please ask before you take on this issue. p-critical Tasks that have immediate deadlines or significant consequences if not completed on time. s-L (several weeks) Complex tasks that require significant time investment and coordination across teams a-critical needs a lot of work labels Sep 24, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
a-critical needs a lot of work docs-audit-2024-Q4 OP Labs documentation audit op-labs Generally assigned for OP Labs employees. Please ask before you take on this issue. p-critical Tasks that have immediate deadlines or significant consequences if not completed on time. s-L (several weeks) Complex tasks that require significant time investment and coordination across teams
Projects
None yet
Development

No branches or pull requests

1 participant