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

Docs: reorganize user manual section in docs website #2102

Merged
merged 19 commits into from
Nov 12, 2024

Conversation

jpraynaud
Copy link
Member

@jpraynaud jpraynaud commented Nov 7, 2024

Content

This PR includes significant updates to the user manual documentation for Mithril, including new sections and reorganized content. The changes aim to improve the clarity and accessibility of the information for developers and users.

Note

  • Screenshots are available on this slideshow

Documentation Updates:

  • Added redirects for several URLs to ensure users are directed to the correct pages. (docs/website/docusaurus.config.js)
  • Created a new Develop section with a README and category configuration. (docs/website/root/manual/develop/README.mdx, docs/website/root/manual/develop/_category_.json) [1] [2]
  • Renamed and updated several documentation files to improve clarity and organization. (docs/website/root/manual/develop/nodes/mithril-signer.md, docs/website/root/manual/develop/protocol-simulation.md, docs/website/root/manual/develop/references.md, docs/website/root/manual/develop/run-mithril-devnet.md) [1] [2] [3] [4]

Dependency Updates:

  • Updated package.json and package-lock.json to include new plugins and update the version. (docs/website/package.json, docs/website/package-lock.json) [1] [2]

Structural Changes:

  • Removed the outdated Developer Docs category configuration. (docs/website/root/manual/developer-docs/_category_.json)
  • Added a new Getting Started section with a README and category configuration. (docs/website/root/manual/getting-started/README.mdx, docs/website/root/manual/getting-started/_category_.json) [1] [2]
  • Updated the Bootstrap a Cardano node documentation to adjust the sidebar position and remove the Mithril networks note. (docs/website/root/manual/getting-started/bootstrap-cardano-node.md) [1] [2]
  • Added a new Network configurations documentation file. (docs/website/root/manual/getting-started/network-configurations.md)

Pre-submit checklist

  • Branch
    • Commit sequence broadly makes sense
    • Key commits have useful messages
  • PR
    • No clippy warnings in the CI
    • Self-reviewed the diff
    • Useful pull request description
    • Reviewer requested
  • Documentation
    • Update documentation website (if relevant)

Issue(s)

Relates to #2101

@jpraynaud jpraynaud self-assigned this Nov 7, 2024
@jpraynaud jpraynaud changed the title docs: re organize user manual section in docs website Docs: reorganize user manual section in docs website Nov 7, 2024
Copy link

github-actions bot commented Nov 7, 2024

Test Results

    4 files  ±0     51 suites  ±0   11m 4s ⏱️ -4s
1 437 tests ±0  1 437 ✅ ±0  0 💤 ±0  0 ❌ ±0 
1 648 runs  ±0  1 648 ✅ ±0  0 💤 ±0  0 ❌ ±0 

Results for commit 6e6c776. ± Comparison against base commit 57af397.

♻️ This comment has been updated with latest results.

@jpraynaud jpraynaud force-pushed the jpraynaud/2101-update-doc-website-user-manual branch from 2471c74 to 9a6cdfd Compare November 8, 2024 14:28
@jpraynaud jpraynaud marked this pull request as ready for review November 8, 2024 14:33
docs/website/root/manual/getting-started/README.mdx Outdated Show resolved Hide resolved
docs/website/root/manual/getting-started/_category_.json Outdated Show resolved Hide resolved
@@ -61,7 +61,7 @@ Switch to the desired branch/tag:

```bash
# Replace **YOUR_BUILD_BRANCH_OR_TAG** with the appropriate branch or tag name
# Please refer to the **Build from** column of the **Mithril networks** table above
# Please refer to the **Build from** column of the **Mithril networks** section
Copy link
Collaborator

Choose a reason for hiding this comment

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

There are many mentions of this note throughout the guide. I changed the 'table' to 'section'. However, I think it's best to update these notes to say 'Network configurations' and link to a newly created section.

Copy link
Member Author

Choose a reason for hiding this comment

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

Done in aada22b ✔️

Copy link
Collaborator

@sfauvel sfauvel left a comment

Choose a reason for hiding this comment

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

LGTM

Copy link
Collaborator

@dlachaume dlachaume left a comment

Choose a reason for hiding this comment

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

LGTM 🚀

@jpraynaud jpraynaud force-pushed the jpraynaud/2101-update-doc-website-user-manual branch from 751695f to 77206dc Compare November 12, 2024 09:41
@jpraynaud jpraynaud force-pushed the jpraynaud/2101-update-doc-website-user-manual branch from 77206dc to 5b5321e Compare November 12, 2024 09:53
@jpraynaud jpraynaud force-pushed the jpraynaud/2101-update-doc-website-user-manual branch from 5b5321e to 6e6c776 Compare November 12, 2024 10:13
@jpraynaud jpraynaud merged commit c936b60 into main Nov 12, 2024
50 checks passed
@jpraynaud jpraynaud deleted the jpraynaud/2101-update-doc-website-user-manual branch November 12, 2024 13:21
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.

4 participants