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

Fix Broken Docs References #5436

Open
wants to merge 7 commits into
base: master
Choose a base branch
from

Conversation

arr00
Copy link
Contributor

@arr00 arr00 commented Jan 16, 2025

This PR fixes broken references in the generated docs.

PR Checklist

  • Tests
  • Documentation
  • Changeset entry (run npx changeset add)

Copy link

changeset-bot bot commented Jan 16, 2025

⚠️ No Changeset found

Latest commit: 4d6d35e

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@arr00 arr00 changed the title WIP: Fix Broken Docs References Fix Broken Docs References Jan 17, 2025
@arr00 arr00 requested review from ernestognw and Amxx and removed request for ernestognw January 17, 2025 06:21
@Amxx Amxx added the documentation Inline comments, guides, and examples. label Jan 22, 2025
@@ -159,7 +159,7 @@ abstract contract ERC721Consecutive is IERC2309, ERC721 {
}

/**
* @dev Used to offset the first token id in {_nextConsecutiveId}
* @dev Used to offset the first token id in `_nextConsecutiveId`
Copy link
Collaborator

Choose a reason for hiding this comment

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

Note: the rational here is that _nextConsecutiveId is a private function, and therefore doesn't appear in the docs

Copy link
Member

Choose a reason for hiding this comment

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

Yeah this is important. I've personally like everything documented regardless of whether the function is private but is true that references to these functions are broken

.gitignore Show resolved Hide resolved
contracts/proxy/utils/UUPSUpgradeable.sol Show resolved Hide resolved
@@ -159,7 +159,7 @@ abstract contract ERC721Consecutive is IERC2309, ERC721 {
}

/**
* @dev Used to offset the first token id in {_nextConsecutiveId}
* @dev Used to offset the first token id in `_nextConsecutiveId`
Copy link
Member

Choose a reason for hiding this comment

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

Yeah this is important. I've personally like everything documented regardless of whether the function is private but is true that references to these functions are broken

docs/templates/properties.js Show resolved Hide resolved
docs/templates/properties.js Show resolved Hide resolved
arr00

This comment was marked as resolved.

@arr00
Copy link
Contributor Author

arr00 commented Jan 22, 2025

No changes in this PR apply to code merged since v5.2.0. It can be cherry-picked onto the docs branch easily.

@arr00 arr00 requested a review from Amxx January 23, 2025 17:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Inline comments, guides, and examples. ignore-changeset
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants