celestiaorg / celestia-specs

Celestia Specifications
Creative Commons Zero v1.0 Universal
51 stars 14 forks source link

Migrate specs to individual repos #212

Open rootulp opened 2 years ago

rootulp commented 2 years ago

Context

Candidates Repos

It may aid discoverability if these specs are migrated to a consistent location across repos (i.e. specs/)

Cursory Breakdown

Page Repo Notes
architecture.md docs or celestia.org
block_proposer.md celestia-app
consensus.md celestia-core
data_structures.md celestia-app ~or celestia-core~
light_client.md empty so removable
networking.md celestia-app ~or celestia-core~
node_types.md celestia-node
specification.md table of contents so removable
distributing_rewards.md celestia-core
fork_choice_das.md docs or celestia.org
message_block_layout.md celestia-app
rationale.md table of contents so removable
rewards.md celestia-core
rootulp commented 2 years ago

One downside to this migration is that pages will be split across repos so existing relative links must be converted to absolute links to avoid breakage. Example the relative link ./consensus.md on this line will be invalid after this migration and should likely be replaced with the absolute link https://github.com/celestiaorg/celestia-core/tree/v0.34.x-celestia/specs/consensus.md

rootulp commented 2 years ago

After migration, we should use the Transfer issue feature to migrate issues to the relevant repo. @liamsi can you please give me write access on this repo in order to do this?

rootulp commented 2 years ago

Blocked on https://github.com/celestiaorg/celestia-app/issues/730

adlerjohn commented 2 years ago

can you please give me write access on this repo in order to do this?

done