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

Refactor and improve documentation: Formatting, clarity, and link validation #3509

Open
wants to merge 6 commits into
base: main
Choose a base branch
from

Conversation

sergeypanin1994
Copy link

Refactor and improve documentation: Formatting, clarity, and link validation

  • Corrected various formatting issues across multiple templates and documentation files.
  • Improved readability and clarity of explanations, including the Charon setup, DKG process, and consensus protocols.
  • Updated and clarified the branching, release process, and feature-specific configurations.
  • Fixed minor grammatical errors and ensured consistency throughout the documentation.
  • Verified and updated all external links to ensure they are valid and accessible.

If you need further improvements or additional clarifications, feel free to reach out. I'm happy to assist with any further updates or questions.

- Corrected capitalization of "Charon" in the template
- Added punctuation to test steps for consistency
- Improved overall text form
- Closed unclosed comment block in the template
- Improved error log description for better clarity
- Enhanced readability by cleaning up formatting
- Fixed minor typos and grammatical errors
- Updated and clarified explanations of branching and release processes
- Added explanations for "stacked diffs" and "feature switches"
- Improved clarity of release process steps
- Checked and confirmed all external links are valid
- Corrected inconsistencies in the explanation of consensus protocol selection and the Priority protocol.
- Improved clarity in descriptions of consensus round timers and their configurations.
- Fixed formatting issues in JSON examples and enhanced readability.
- Updated details on observability and protocol-specific configuration.
- Refined language for better understanding of key concepts and processes.

This update improves the overall quality and readability of the documentation.
…Distributed Validator Key Generation documentation

- Corrected formatting and fixed text errors throughout the document
- Updated link references to ensure they are correct and accessible
- Improved clarity in the description of the Distributed Key Generation (DKG) ceremony process
- Added clarification for key verification steps in the DKG process
- Fixed minor grammatical issues
…tart instructions

- Enhanced clarity and readability of the project description.
- Improved formatting for better readability, including headings and links.
- Updated the quickstart section with a more direct approach.
- Reworded sections for better understanding and flow.
- Fixed minor grammatical and formatting issues throughout the documentation.
Copy link

sonarqubecloud bot commented Feb 6, 2025

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant