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

doc: make doc examples testable in ci #326

Merged
merged 15 commits into from
Jan 13, 2025

Conversation

dj8yfo
Copy link
Collaborator

@dj8yfo dj8yfo commented Dec 28, 2024

resolves #325

the meaningful part of changes are in commits named doc: replace ignore -> rust whereever possible and the like

@dj8yfo dj8yfo force-pushed the testable_docs_of_derive_macros branch from 8a33f86 to 865fe12 Compare December 28, 2024 20:09
Comment on lines +297 to +310
pub fn add_definitions_recursively<K: BorshSchema, V: BorshSchema>(
definitions: &mut BTreeMap<Declaration, Definition>,
) {
let definition = Definition::Sequence {
elements: <(K, V)>::declaration(),
length_width: Definition::DEFAULT_LENGTH_WIDTH,
length_range: Definition::DEFAULT_LENGTH_RANGE,
};
let no_recursion_flag = definitions.get(&declaration::<K, V>()).is_none();
schema::add_definition(declaration::<K, V>(), definition, definitions);
if no_recursion_flag {
<(K, V)>::add_definitions_recursively(definitions);
}
}
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

this api was actually out of date

@dj8yfo dj8yfo marked this pull request as ready for review December 28, 2024 23:48
@dj8yfo dj8yfo requested review from frol and akorchyn as code owners December 28, 2024 23:48
@dj8yfo dj8yfo force-pushed the testable_docs_of_derive_macros branch from da1d6fc to ba3b63a Compare December 29, 2024 00:15
@dj8yfo
Copy link
Collaborator Author

dj8yfo commented Dec 29, 2024

@race-of-sloths include

@race-of-sloths
Copy link

race-of-sloths commented Dec 29, 2024

@dj8yfo Thank you for your contribution! Your pull request is now a part of the Race of Sloths!

Shows inviting banner with latest news.

Shows profile picture for the author of the PR

Current status: executed
Reviewer Score
@akorchyn 8

Your contribution is much appreciated with a final score of 8!
You have received 110 (80 base + 15 weekly bonus + 15% lifetime bonus) Sloth points for this contribution

@akorchyn received 25 Sloth Points for reviewing and scoring this pull request.

Another weekly streak completed, well done @dj8yfo! To keep your weekly streak and get another bonus make pull request next week! Looking forward to see you in race-of-sloths

What is the Race of Sloths

Race of Sloths is a friendly competition where you can participate in challenges and compete with other open-source contributors within your normal workflow

For contributors:

  • Tag @race-of-sloths inside your pull requests
  • Wait for the maintainer to review and score your pull request
  • Check out your position in the Leaderboard
  • Keep weekly and monthly streaks to reach higher positions
  • Boast your contributions with a dynamic picture of your Profile

For maintainers:

  • Score pull requests that participate in the Race of Sloths and receive a reward
  • Engage contributors with fair scoring and fast responses so they keep their streaks
  • Promote the Race to the point where the Race starts promoting you
  • Grow the community of your contributors

Feel free to check our website for additional details!

Bot commands
  • For contributors
    • Include a PR: @race-of-sloths include to enter the Race with your PR
  • For maintainers:
    • Invite contributor @race-of-sloths invite to invite the contributor to participate in a race or include it, if it's already a runner.
    • Assign points: @race-of-sloths score [1/2/3/5/8/13] to award points based on your assessment.
    • Reject this PR: @race-of-sloths exclude to send this PR back to the drawing board.
    • Exclude repo: @race-of-sloths pause to stop bot activity in this repo until @race-of-sloths unpause command is called

Copy link
Collaborator

@akorchyn akorchyn left a comment

Choose a reason for hiding this comment

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

To be honest, not sure that I like the idea of moving docs into the md as it ruins the developer experience when you jump from the IDE. Just a point for you to think 👍🏻
@race-of-sloths score 8

use core::hash::Hash;

/// this a stub module, representing a 3rd party crate `indexmap`
mod indexmap {
Copy link
Collaborator

Choose a reason for hiding this comment

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

We might hide it I guess

@dj8yfo dj8yfo merged commit d23b18f into near:master Jan 13, 2025
7 checks passed
@frol frol mentioned this pull request Jan 13, 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.

doc: testable doc snippets
3 participants