Make semver module public and add documentation

[billf]

Expose semver module and improve its documentation

This PR makes the semver module public and adds comprehensive documentation to improve its usability. The changes include:

• Added module-level documentation explaining the purpose of VersionMap
• Added detailed documentation for the VersionMap struct and all its methods
• Added explanations of the alternate version lookup logic
• Included a usage example in the documentation
• Added documentation for internal fields and helper functions
• Improved code readability with more descriptive comments

These changes make the semantic versioning functionality available to consumers of the library and provide clear guidance on how to use it effectively.

[billf]

• Make semver module public and add documentation #2 👈 (View in Graphite)
• master

This stack of pull requests is managed by Graphite. Learn more about stacking.

[Copilot]

Pull Request Overview

This PR makes the semver module public and enriches its VersionMap API with comprehensive documentation.

• Exposes semver in the crate’s public API.
• Adds module- and item-level docs, including usage examples and alternate lookup logic.
• Documents all VersionMap methods and internal helpers.

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
src/semver.rs	Added public docs for VersionMap, its methods, and version_alternate.
src/lib.rs	Changed mod semver; to pub mod semver; to expose the module.

Comments suppressed due to low confidence (1)

src/semver.rs:19

• Add unit tests for the alternate lookup logic covering: pre-release versions (should return None), major-version fallback, minor-version fallback when major is 0, and patch-level fallback. Also test get_or_latest behavior when None is provided or when the map is empty.

- For minor versions > 0 (when major is 0): alternate is `0.minor.0`

[graphite-app]

Graphite Automations

"Request reviewers once CI passes" took an action on this PR • (05/27/25)

1 assignee was added and 1 reviewer was added to this PR based on bill fumerola's automation.

[Copilot]

Pull Request Overview

This PR exposes the semver module publicly and enhances its documentation to improve clarity and usability.

• Made the semver module public in lib.rs
• Added comprehensive module- and method-level documentation in src/semver.rs
• Included detailed usage examples and alternate lookup logic documentation

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
src/semver.rs	Added documentation, new methods, and alternate lookup logic for VersionMap.
src/lib.rs	Updated semver module from private to public.

Comments suppressed due to low confidence (1)

src/semver.rs:109

• The alternate lookup condition in get() checks version.build.is_empty(), but according to the alternate logic and the version_alternate() implementation, it should check if version.pre is empty to correctly bypass alternate lookups for pre-release versions.

if version.build.is_empty() {