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

UG > PagNav: Misleading sentence #2440

Merged
merged 12 commits into from
Mar 9, 2024

Conversation

KevinEyo1
Copy link
Contributor

What is the purpose of this pull request?

  • Documentation update
  • Bug fix
  • Feature addition or enhancement
  • Code maintenance
  • DevOps
  • Improve developer experience
  • Others, please explain:

Overview of changes:
Fixes #2412
Updated documentation to avoid misleading wording.

Anything you'd like to highlight/discuss:

Testing instructions:

Proposed commit message: (wrap lines at 72 characters)
UG: update wording of UG

Wording might mislead readers into thinking that PageNavs
cannot be used in normal pages.

Updating the wording will allow readers to know that
individual pages can also use PageNavs.

Let's update the wording to be clearer and more explicit.


Checklist: ☑️

  • Updated the documentation for feature additions and enhancements
  • Added tests for bug fixes or features
  • Linked all related issues
  • No unrelated changes

Reviewer checklist:

Indicate the SEMVER impact of the PR:

  • Major (when you make incompatible API changes)
  • Minor (when you add functionality in a backward compatible manner)
  • Patch (when you make backward compatible bug fixes)

At the end of the review, please label the PR with the appropriate label: r.Major, r.Minor, r.Patch.

Breaking change release note preparation (if applicable):

  • To be included in the release note for any feature that is made obsolete/breaking

Give a brief explanation note about:

  • what was the old feature that was made obsolete
  • any replacement feature (if any), and
  • how the author should modify his website to migrate from the old feature to the replacement feature (if possible).

Copy link

codecov bot commented Mar 2, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 48.92%. Comparing base (7d10b69) to head (e32a20d).

Additional details and impacted files
@@           Coverage Diff           @@
##           master    #2440   +/-   ##
=======================================
  Coverage   48.92%   48.92%           
=======================================
  Files         124      124           
  Lines        5245     5245           
  Branches     1110     1110           
=======================================
  Hits         2566     2566           
  Misses       2371     2371           
  Partials      308      308           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@KevinEyo1 KevinEyo1 marked this pull request as ready for review March 2, 2024 19:03
@@ -4,7 +4,7 @@

<div id="content">

**A _Page Navigation Menu_ (==_pageNav_ for short==) a list of the current page's headings.** Page navigation menus are only available for use in [layouts]({{baseUrl}}/userGuide/tweakingThePageStructure.html#layouts).
**A _Page Navigation Menu_ (==_pageNav_ for short==) displays a list of the current page's headings.** Page navigation menus are typically used in [layouts]({{baseUrl}}/userGuide/tweakingThePageStructure.html#layouts), but they can also be utilized in individual pages.
Copy link
Contributor

Choose a reason for hiding this comment

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

'used in layouts' still doesn't sound right. It's more like set/configured/controlled via the layouts mechanism.

Copy link
Contributor

@yucheng11122017 yucheng11122017 left a comment

Choose a reason for hiding this comment

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

LGTM! Thank you @KevinEyo1

KevinEyo1 and others added 2 commits March 9, 2024 22:27
Co-authored-by: david <71922282+itsyme@users.noreply.github.com>
@itsyme
Copy link
Contributor

itsyme commented Mar 9, 2024

LGTM! Thanks for the work @KevinEyo1

@itsyme itsyme merged commit 1c01cfb into MarkBind:master Mar 9, 2024
9 checks passed
@itsyme itsyme added the r.Minor Version resolver: increment by 0.1.0 label Mar 9, 2024
@itsyme itsyme added this to the v5.3.1 milestone Mar 9, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
r.Minor Version resolver: increment by 0.1.0
Projects
None yet
Development

Successfully merging this pull request may close these issues.

UG > PagNav: Misleading sentence
4 participants