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

Add detailed rustdoc to reftests #1232

Merged
merged 1 commit into from
Jan 15, 2025

Conversation

dannycjones
Copy link
Contributor

The reference tests for Mountpoint can be quite complex, especially for those unfamiliar both with the tests themselves or the idea of reference-based testing.

This change adds more detailed rustdoc with the goal to ramp up new readers with the reftests, give an overview of what the tests are doing, and point the reader to resources for learning more.

Does this change impact existing behavior?

No, all code documentation changes.

Does this change need a changelog entry? Does it require a version change?

No, code doc changes only.


By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and I agree to the terms of the Developer Certificate of Origin (DCO).

Signed-off-by: Daniel Carl Jones <[email protected]>
@dannycjones dannycjones requested a review from c-hagem January 14, 2025 19:34
@dannycjones dannycjones temporarily deployed to PR integration tests January 14, 2025 19:34 — with GitHub Actions Inactive
@dannycjones dannycjones temporarily deployed to PR integration tests January 14, 2025 19:34 — with GitHub Actions Inactive
@dannycjones dannycjones temporarily deployed to PR integration tests January 14, 2025 19:34 — with GitHub Actions Inactive
@dannycjones dannycjones temporarily deployed to PR integration tests January 14, 2025 19:34 — with GitHub Actions Inactive
@dannycjones dannycjones temporarily deployed to PR integration tests January 14, 2025 19:34 — with GitHub Actions Inactive
@dannycjones dannycjones temporarily deployed to PR integration tests January 14, 2025 19:34 — with GitHub Actions Inactive
@dannycjones dannycjones temporarily deployed to PR integration tests January 14, 2025 19:34 — with GitHub Actions Inactive
Copy link
Contributor

@c-hagem c-hagem left a comment

Choose a reason for hiding this comment

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

I think these are great additions. I was wondering if we should go into more depth with regards to how the reference construction / the comparison works (but maybe this can wait until we decide what, if anything, we would change there)?

@dannycjones
Copy link
Contributor Author

I think these are great additions. I was wondering if we should go into more depth with regards to how the reference construction / the comparison works (but maybe this can wait until we decide what, if anything, we would change there)?

I think that sounds good, although I don't necessarily have time to spend on digging deeper there. Would you mind leaving it for a future PR (which you may be able to introduce)?

@c-hagem c-hagem added this pull request to the merge queue Jan 15, 2025
Merged via the queue into awslabs:main with commit d008177 Jan 15, 2025
24 checks passed
@dannycjones dannycjones deleted the add-detailed-rustdoc-reftests branch January 15, 2025 12:43
keremnc pushed a commit to keremnc/mountpoint-s3 that referenced this pull request Jan 24, 2025
The reference tests for Mountpoint can be quite complex, especially for
those unfamiliar both with the tests themselves or the idea of
reference-based testing.

This change adds more detailed rustdoc with the goal to ramp up new
readers with the reftests, give an overview of what the tests are doing,
and point the reader to resources for learning more.

### Does this change impact existing behavior?

No, all code documentation changes.

### Does this change need a changelog entry? Does it require a version
change?

No, code doc changes only.

---

By submitting this pull request, I confirm that my contribution is made
under the terms of the Apache 2.0 license and I agree to the terms of
the [Developer Certificate of Origin
(DCO)](https://developercertificate.org/).

Signed-off-by: Daniel Carl Jones <[email protected]>
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.

2 participants