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

Handles Pallet Documentation Improvement #1984

Merged
merged 6 commits into from
May 31, 2024
Merged

Handles Pallet Documentation Improvement #1984

merged 6 commits into from
May 31, 2024

Conversation

wilwade
Copy link
Collaborator

@wilwade wilwade commented May 24, 2024

Goal

The goal of this PR is to improve the documentation of the Pallets and make that documentation be able to be used on docs.frequency.xyz.

Part of frequency-chain/docs#59

Discussion

  • Handles Pallet Readme

Screenshot

image

//!
//! ## Overview
//! ## Shuffled Sequences
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Added in a rust only section on the shuffled sequences. They are just odd without that extra context.

| Get Handle by MSA Id | Returns the Display Handle and the block it was claimed | `msaIdToDisplayName` | 29 |
| Get MSA Id by canonical string and suffix | Uses the stored canonical lookup string NOT the display handle | `canonicalBaseHandleAndSuffixToMSAId` | 29 |

See the [Rust Docs](https://frequency-chain.github.io/frequency/pallet_handles/pallet/storage_types/index.html) for additional state queries and details.
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Yes, I left out the canonical to suffix index. It just doesn't make sense for anyone to really use it directly, but that's why we always have this line.

Copy link

codecov bot commented May 24, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Files Coverage Δ
pallets/handles/src/lib.rs 91.45% <100.00%> (ø)

Copy link
Collaborator

@shannonwells shannonwells left a comment

Choose a reason for hiding this comment

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

lgtm!

@wilwade wilwade marked this pull request as ready for review May 29, 2024 17:59
@wilwade wilwade requested review from a team, mattheworris, enddynayn, aramikm, claireolmstead and JoeCap08055 and removed request for a team May 29, 2024 17:59
Copy link
Collaborator

@claireolmstead claireolmstead left a comment

Choose a reason for hiding this comment

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

teeny fix. otherwise, very readable and clear.

Copy link
Collaborator

@enddynayn enddynayn left a comment

Choose a reason for hiding this comment

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

👍 superb!

@wilwade wilwade enabled auto-merge (squash) May 31, 2024 15:58
@wilwade wilwade merged commit 3625aed into main May 31, 2024
28 checks passed
@wilwade wilwade deleted the docs/handles branch May 31, 2024 16:26
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.

5 participants