-
Notifications
You must be signed in to change notification settings - Fork 96
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
Update Control Plane Configuration documentation for Hugo formatting #1296
Update Control Plane Configuration documentation for Hugo formatting #1296
Conversation
This commit updates the control plane configuration documentation to match NGINX's standardised Hugo formatting conventions: specifically, avoiding breaking sentences across line and the use of shortcodes for a note. There are also some minor content changes for product noun conventions and rephrasing a few sentences.
@@ -1,26 +1,25 @@ | |||
--- | |||
title: "Control Plane Configuration" | |||
description: "Learn how to dynamically update the NGINX Gateway Fabric control plane configuration." | |||
description: "Learn how to dynamically update the F5 NGINX Gateway Fabric control plane configuration." |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I don't think F5 should be in the name here, our product doesn't include that in its name.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
following up on that
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Getting clarification from further up if Gateway is an exception: the first instance of any NGINX product name on any page is always prepended by F5. This description is currently visible to the end user but will not be in the future, as it's HTML metadata.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Removing it for now.
I'm going to attempt to run the precommit hooks locally to resolve the linting errors: if there's no edit suggestions before then I will attempt a |
site/content/how-to/configuration/control-plane-configuration.md
Outdated
Show resolved
Hide resolved
site/content/how-to/configuration/control-plane-configuration.md
Outdated
Show resolved
Hide resolved
site/content/how-to/configuration/control-plane-configuration.md
Outdated
Show resolved
Hide resolved
* Migrate docs to docs.nginx.com (#1226) Change docs structure and add the required files to build documentation Hugo and publish with Netlify Rewrite existing docs to work with Hugo --------- Co-authored-by: Travis Martin <[email protected]> Co-authored-by: Travis Martin <[email protected]> Co-authored-by: Kate Osborn <[email protected]> Co-authored-by: Alan Dooley <[email protected]> Co-authored-by: Alan Dooley <[email protected]> * fix: fix links in github docs to d-n-c (#1291) * Fix installation docs for mismatched versions (#1287) Problem: Our installation docs suggested installing Gateway API v1 and NGF v1, which are not compatible. Solution: Fix the docs to mention both stable and edge versions, with proper versioning. Also updated the release process doc to ensure these are updated at release time as needed. * Update Control Plane Configuration documentation for Hugo formatting (#1296) This commit updates the control plane configuration documentation to match NGINX's standardised Hugo formatting conventions: specifically, avoiding breaking sentences across line and the use of shortcodes for a note. There are also some minor content changes for product noun conventions and rephrasing a few sentences. --------- Co-authored-by: Jon Torre <[email protected]> * docs: update architecture doc (#1295) * docs: update architecture doc * chore: update architecture description --------- Co-authored-by: Alan Dooley <[email protected]> --------- Co-authored-by: Jon Torre <[email protected]> Co-authored-by: Travis Martin <[email protected]> Co-authored-by: Travis Martin <[email protected]> Co-authored-by: Kate Osborn <[email protected]> Co-authored-by: Alan Dooley <[email protected]> Co-authored-by: Alan Dooley <[email protected]>
Proposed changes
This commit updates the control plane configuration documentation to match NGINX's standardised Hugo formatting conventions: specifically, avoiding breaking sentences across line and the use of shortcodes for a note. There are also some minor content changes for product noun conventions and rephrasing a few sentences.
Checklist
Before creating a PR, run through this checklist and mark each as complete.