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

feat: Improve README.md structure #323

Merged
merged 11 commits into from
Nov 8, 2024
Merged

Conversation

georgi-l95
Copy link
Contributor

@georgi-l95 georgi-l95 commented Oct 29, 2024

Description:
This PR aims to improve the README.md structure and make it easier for new user and contributors to find their way around.
NOTES:

  • Server readme has to be fixed
  • Server configuration also

Related issue(s):

Fixes #320
Fixes #263
Fixes #325

Notes for reviewer:

Checklist

  • Documented (Code comments, README, etc.)
  • Tested (unit, integration, etc.)

@georgi-l95 georgi-l95 self-assigned this Oct 29, 2024
@georgi-l95 georgi-l95 linked an issue Oct 29, 2024 that may be closed by this pull request
@georgi-l95 georgi-l95 added the Documentation Issues/PR related to documentation label Oct 29, 2024
@georgi-l95 georgi-l95 added this to the 0.2.0 milestone Oct 29, 2024
@georgi-l95 georgi-l95 marked this pull request as ready for review October 29, 2024 14:00
@georgi-l95 georgi-l95 requested review from a team as code owners October 29, 2024 14:00
Copy link
Contributor

@ata-nas ata-nas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some general questions and suggestions that we can think about

README.md Show resolved Hide resolved
docs/README.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/configuration.md Outdated Show resolved Hide resolved
docs/README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
@georgi-l95 georgi-l95 marked this pull request as draft October 31, 2024 14:26
@ata-nas ata-nas force-pushed the 320-reorganize-readmemd branch from 0644e6d to dcca6b2 Compare November 1, 2024 11:42
@ata-nas ata-nas self-assigned this Nov 1, 2024
@ata-nas ata-nas force-pushed the 320-reorganize-readmemd branch from 81452bb to 03bdb3f Compare November 5, 2024 08:00
@ata-nas ata-nas marked this pull request as ready for review November 5, 2024 08:53
Copy link
Member

@jsync-swirlds jsync-swirlds left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some formatting comments.
Content seems reasonable.

One general comment:
Some files use horizontal rules (--- alone in markdown) before each header. It is entirely a matter of opinion, but I find that these tend to break up the text quite a bit more than necessary and it might be better to remove those.

docs/Protocol/README.md Outdated Show resolved Hide resolved
server/docs/configuration.md Outdated Show resolved Hide resolved
server/docs/configuration.md Outdated Show resolved Hide resolved
tools/docs/quickstart.md Outdated Show resolved Hide resolved
Copy link
Contributor

@mattp-swirldslabs mattp-swirldslabs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good

georgi-l95 and others added 9 commits November 7, 2024 18:02
Signed-off-by: georgi-l95 <[email protected]>
Signed-off-by: georgi-l95 <[email protected]>
Signed-off-by: Atanas Atanasov <[email protected]>
Signed-off-by: Atanas Atanasov <[email protected]>
Signed-off-by: Atanas Atanasov <[email protected]>
Signed-off-by: Atanas Atanasov <[email protected]>
Signed-off-by: Atanas Atanasov <[email protected]>
Signed-off-by: Atanas Atanasov <[email protected]>
@ata-nas ata-nas force-pushed the 320-reorganize-readmemd branch from 2628530 to 3324c4d Compare November 7, 2024 16:02
@mattp-swirldslabs mattp-swirldslabs merged commit 76811f0 into main Nov 8, 2024
13 checks passed
@mattp-swirldslabs mattp-swirldslabs deleted the 320-reorganize-readmemd branch November 8, 2024 19:56
Copy link

codecov bot commented Nov 8, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 98.48%. Comparing base (a6ecd97) to head (3324c4d).
Report is 2 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff            @@
##               main     #323   +/-   ##
=========================================
  Coverage     98.48%   98.48%           
  Complexity      294      294           
=========================================
  Files            63       63           
  Lines          1119     1119           
  Branches         79       79           
=========================================
  Hits           1102     1102           
  Misses           11       11           
  Partials          6        6           

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Documentation Issues/PR related to documentation
Projects
None yet
5 participants