stellar / stellar-docs

Documentation for Stellar
https://developers.stellar.org
Apache License 2.0
54 stars 123 forks source link

🗳️ Prettify, contextualize SCP page #767

Open JFWooten4 opened 1 month ago

JFWooten4 commented 1 month ago

What problem does your feature solve?

SCP is a major innovation from the early days of web3, pioneering FBA without a trusted node registry, wasteful PoW, or existing financial stakes. 💡

While the SCP paper amply describes the system, the learn page offers a stellar opportunity to document the modern contexts of SCP operations.

We think it makes sense to give clear details here given the community actively works to validate, improve, and popularize SCP.

What would you like to see? 🧐

While the page as it stands today introduces some of the primary concepts behind SCP, it does so without much context.

Namely, the original SCP paper frames the system in terms of alternatives, mathematical proofs, and thorough descriptives. 🧮

Might we incorporate some of the main explanative concepts into this page with a refresh introducing consensus diagrams, network topology, and operative incentives.

What alternatives are there?

We could leave this important documentation to the main SDF pages, which they seem to have developed given the importance of SCP.

However, this may promote centralization concerns since the stellar.org website is not an open-source community resource. 🌐

Instead of developing the documentation here, an alternative could be open-sourcing the main site, like the research site. 👩🏼‍💻

briwylde08 commented 1 month ago

Loving these issues, thank you so much for your ideas!!