Skip to content

Conversation

Jordymalone
Copy link
Contributor

@Jordymalone Jordymalone commented Sep 9, 2025

Introduce the 'cleveref' package to the document. This package allows for intelligent cross-referencing that automatically includes the reference type (e.g., "Section" or "Figure").

The change replaces all instances of \ref{...} with \Cref{...}. This improves document readability and simplifies maintenance by removing the need for manual text prefixes like "Section" or "Figure" before a reference.

This aligns with contributor suggestions to adopt cleveref for better maintenance of cross-references across the document.


Summary by cubic

Add the cleveref package and switch all cross-references from \ref to \Cref for automatic, type-aware labels. This improves readability and removes the need for manual "Section"/"Figure" prefixes.

  • Migration
    • Use \Cref{label} for all new cross-references.
    • Do not add manual prefixes like "Section" or "Figure" before references.

Copy link

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

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

No issues found across 1 file

Copy link
Collaborator

@EricccTaiwan EricccTaiwan left a comment

Choose a reason for hiding this comment

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

I tested it, and nothing broke.
LGTM, thanks!

@EricccTaiwan EricccTaiwan requested a review from jserv September 9, 2025 16:01
Introduce the 'cleveref' package to the document. This package allows
for intelligent cross-referencing that automatically includes the
reference type (e.g., "Section" or "Figure").

The change replaces all instances of \ref{...} with \Cref{...}. This
improves document readability and simplifies maintenance by removing the
need for manual text prefixes like "Section" or "Figure" before a
reference.

This aligns with contributor suggestions to adopt cleveref for better
maintenance of cross-references across the document.

Signed-off-by: Chia-Hao Chiu <[email protected]>
@jserv jserv merged commit 156cf71 into sysprog21:master Sep 9, 2025
1 check passed
@jserv
Copy link
Contributor

jserv commented Sep 9, 2025

Thank @Jordymalone for contributing!

@Jordymalone Jordymalone deleted the add-cref branch September 10, 2025 03:49
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.

3 participants