Consul Documentation restructure according to IA & content strategy #22041
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…f-docs-ia Docs/CE-757-move-latest-version-of-docs-ia
* upgrade openshift deployment * openshift: improve upgrade article * openshift: add redhat word to openshift term * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * revision after code review --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com>
Agent: Fix remaining agent config refs
Copy edit of "Draft Completed"
aimeeu
previously approved these changes
Apr 30, 2025
nitin-sachdev-29
approved these changes
May 5, 2025
4 tasks
boruszak
added a commit
that referenced
this pull request
May 5, 2025
…22041) * migration * nav fixes * nav * Missing top-level pages * nav/content alignment * partial path update * Partial fixes * Partial updates * partial paths * erroneous replacement fix * 3 page migration (test) * /agent migration * CA, cluster peering, & config entries * connect -> Gateways * connect * connect * nav * Dynamic app config * ecs * Tutorials -> docs * Tutorials moved * Updated nav with tutorials in docs * enterprise, install, and k8s through k8s/connect * k8s deployment * finished k8s migration * lambda, nia, nomad * nav fixes * security and discovery * service & upgrade * final page migrations * Nav update * Change navigation and page placement * Revert "Change navigation and page placement" This reverts commit 0934235. * Change navigation and page placement * Fixed broken include. * Updated sync consul service catalog with aws cloud map page. * Update to match page use of cloud map - AWS separates the two words. * Updated register services into a namespace docs page. * Updated explore the consul ui page. * Refactor HAProxy tutorial into usage doc * re-org * architecture and fundamentals * duplicate page deleted * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * Moved consul-aws cli reference to its own page. * partial fix * Fix links and next steps * install and dev mode pages * CodeBlocks * env var page * title changes * Aligning with tracker * nav fixes * tracking alignment * Nav fixes * content checker fixed * Partial path fixes * more partial fixes * remove v2 reference * nav/title adjustments * first 64 find and replaces * /connect and /consul-vs-other * through /nia * finish docs paths * tutorial link paths * Redirects * Redirect updates * another tutorials redirect fix * link path updates * security architecture * Raft backend architecture * Deploy Consul overview * Fixes to redirect tests * Redirects * More redirect fixes * Updated link path replacements * README draft * README * More readme * Readme * Deploy server overview * Deploy client agents and dataplanes * cloud auto join page move * Manage Consul * Clean up * Consul template structure and first content * page name and filepath changes * Index updates * typo * VMs index page * Consul template documentation * disaster recovery and openshift guides (#11) * docs: disaster recovery * docs: openshift * adding OpenShift Local to CRC naming convention * Openshift page restructure * add redundancy-zones link * update openshift guide versions Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> Co-authored-by: boruszak <jeffrey.boruszak@hashicorp.com> Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * /connect * /connect/vm * /connect/k8s * /fundamentals/cli * /fundamentals/cli and /register/service/nomad * /fundamentals/api * /fundamentals/editions (and remove env-var) * /fundamentals/tf and finish /fundamentals/editions * /fundamentals/identity * Fixes for working preview * Fundamentals updates * Agent page updates * Agent reference restructure * Redirects update * CT config * References with links and defaults * Some workflow fixes * Fix some links and images * Gossip and TLS with vault first changes * Gossip and TLS with vault first changes * Replace consul.io for URL deprecation * Bug Bash fixes * More bug bash fixes * nav fix * Final bug bash fixes * Vault TLS consul-template * Name the tool Consul Template * Move auto_config in config reference * Fix links * Updates to architecture * Architecture and use case updates * QoL improvements * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * Glossary improvements * Updates * README updates * Finetuning * final readme updates * Link path changes to fix 500 errors * linkcheck fixes round 2 * round 3 500 error fixes * Errors fixes round 4 * CE-827: adding k8s and openshift tshoot info * Revert "CE-827: adding k8s and openshift tshoot info" This reverts commit a02f21d. * Redhat category rename * Readme updates * CE-846 content and screenshots * Ref/agent remove index; add auto-config file * Fix broken links due to configuration-file dir * CE-851 content and images * Fix content-check errors * lock update + move autopilot * v1.21 updates & release notes * IA/Content strategy readme finalizations * Inline image fix * real img fix * More README + consul.d in agent fundamentals * reviewed dataplane architecture content * review rest of completed drafts in arch * persona/directory index * reviewed fundamentals * Readme toc and final updates * re-order some sections * Final toc for readme * move inline examples to Example section where it made sense. * Ce-835: DNS views (#16) * CE-835 DNS forwarding in OpenShift * CE-835 DNS views in OpenShift * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * CE-827: Troubleshoot OpenShift (#17) * CE-827: adding k8s and openshift tshoot info * CE-827: adding openshift import-image info * CE-827: import-image timeout * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * CE-833: OpenShift page updates (#18) * CE-833: updater versions * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * CE-825: Consul on OpenShift Index Page (#19) * CE-825: Consul on OpenShift Index Page * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * telemetry * configuration file index * ESM and release notes updates * Apply suggestions from code review Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com> * fixes for content check * partial fix * Merge resolution changes * Agent: Fix remaining links to reference/agent# * Copy edits * Update HAProxy load balance guide * review manage/dns * multi-tenant/sameness-group/vm * multi-tenant/samenessgroup/k8s * secure * deploy * CE-834: Upgrade OpenShift (#25) * upgrade openshift deployment * openshift: improve upgrade article * openshift: add redhat word to openshift term * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * revision after code review --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * Cleanup, especially Agent references * content fixes * Error fix --------- Co-authored-by: Daniele Carcasole <daniele@daniele-tt72xnn9y7.homenet.telecomitalia.it> Co-authored-by: danielehc <daniele@hashicorp.com> Co-authored-by: Anthony <russo555@gmail.com> Co-authored-by: Krastin Krastev <krastin@hashicorp.com> Co-authored-by: danielehc <40759828+danielehc@users.noreply.github.com> Co-authored-by: Aimee Ukasick <aimee.ukasick@hashicorp.com> Co-authored-by: Tu Nguyen <im2nguyen@gmail.com> Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com>
boruszak
added a commit
that referenced
this pull request
May 5, 2025
…22041) * migration * nav fixes * nav * Missing top-level pages * nav/content alignment * partial path update * Partial fixes * Partial updates * partial paths * erroneous replacement fix * 3 page migration (test) * /agent migration * CA, cluster peering, & config entries * connect -> Gateways * connect * connect * nav * Dynamic app config * ecs * Tutorials -> docs * Tutorials moved * Updated nav with tutorials in docs * enterprise, install, and k8s through k8s/connect * k8s deployment * finished k8s migration * lambda, nia, nomad * nav fixes * security and discovery * service & upgrade * final page migrations * Nav update * Change navigation and page placement * Revert "Change navigation and page placement" This reverts commit 0934235. * Change navigation and page placement * Fixed broken include. * Updated sync consul service catalog with aws cloud map page. * Update to match page use of cloud map - AWS separates the two words. * Updated register services into a namespace docs page. * Updated explore the consul ui page. * Refactor HAProxy tutorial into usage doc * re-org * architecture and fundamentals * duplicate page deleted * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * Moved consul-aws cli reference to its own page. * partial fix * Fix links and next steps * install and dev mode pages * CodeBlocks * env var page * title changes * Aligning with tracker * nav fixes * tracking alignment * Nav fixes * content checker fixed * Partial path fixes * more partial fixes * remove v2 reference * nav/title adjustments * first 64 find and replaces * /connect and /consul-vs-other * through /nia * finish docs paths * tutorial link paths * Redirects * Redirect updates * another tutorials redirect fix * link path updates * security architecture * Raft backend architecture * Deploy Consul overview * Fixes to redirect tests * Redirects * More redirect fixes * Updated link path replacements * README draft * README * More readme * Readme * Deploy server overview * Deploy client agents and dataplanes * cloud auto join page move * Manage Consul * Clean up * Consul template structure and first content * page name and filepath changes * Index updates * typo * VMs index page * Consul template documentation * disaster recovery and openshift guides (#11) * docs: disaster recovery * docs: openshift * adding OpenShift Local to CRC naming convention * Openshift page restructure * add redundancy-zones link * update openshift guide versions Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> Co-authored-by: boruszak <jeffrey.boruszak@hashicorp.com> Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * /connect * /connect/vm * /connect/k8s * /fundamentals/cli * /fundamentals/cli and /register/service/nomad * /fundamentals/api * /fundamentals/editions (and remove env-var) * /fundamentals/tf and finish /fundamentals/editions * /fundamentals/identity * Fixes for working preview * Fundamentals updates * Agent page updates * Agent reference restructure * Redirects update * CT config * References with links and defaults * Some workflow fixes * Fix some links and images * Gossip and TLS with vault first changes * Gossip and TLS with vault first changes * Replace consul.io for URL deprecation * Bug Bash fixes * More bug bash fixes * nav fix * Final bug bash fixes * Vault TLS consul-template * Name the tool Consul Template * Move auto_config in config reference * Fix links * Updates to architecture * Architecture and use case updates * QoL improvements * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * Glossary improvements * Updates * README updates * Finetuning * final readme updates * Link path changes to fix 500 errors * linkcheck fixes round 2 * round 3 500 error fixes * Errors fixes round 4 * CE-827: adding k8s and openshift tshoot info * Revert "CE-827: adding k8s and openshift tshoot info" This reverts commit a02f21d. * Redhat category rename * Readme updates * CE-846 content and screenshots * Ref/agent remove index; add auto-config file * Fix broken links due to configuration-file dir * CE-851 content and images * Fix content-check errors * lock update + move autopilot * v1.21 updates & release notes * IA/Content strategy readme finalizations * Inline image fix * real img fix * More README + consul.d in agent fundamentals * reviewed dataplane architecture content * review rest of completed drafts in arch * persona/directory index * reviewed fundamentals * Readme toc and final updates * re-order some sections * Final toc for readme * move inline examples to Example section where it made sense. * Ce-835: DNS views (#16) * CE-835 DNS forwarding in OpenShift * CE-835 DNS views in OpenShift * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * CE-827: Troubleshoot OpenShift (#17) * CE-827: adding k8s and openshift tshoot info * CE-827: adding openshift import-image info * CE-827: import-image timeout * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * CE-833: OpenShift page updates (#18) * CE-833: updater versions * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * CE-825: Consul on OpenShift Index Page (#19) * CE-825: Consul on OpenShift Index Page * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * telemetry * configuration file index * ESM and release notes updates * Apply suggestions from code review Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com> * fixes for content check * partial fix * Merge resolution changes * Agent: Fix remaining links to reference/agent# * Copy edits * Update HAProxy load balance guide * review manage/dns * multi-tenant/sameness-group/vm * multi-tenant/samenessgroup/k8s * secure * deploy * CE-834: Upgrade OpenShift (#25) * upgrade openshift deployment * openshift: improve upgrade article * openshift: add redhat word to openshift term * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * revision after code review --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * Cleanup, especially Agent references * content fixes * Error fix --------- Co-authored-by: Daniele Carcasole <daniele@daniele-tt72xnn9y7.homenet.telecomitalia.it> Co-authored-by: danielehc <daniele@hashicorp.com> Co-authored-by: Anthony <russo555@gmail.com> Co-authored-by: Krastin Krastev <krastin@hashicorp.com> Co-authored-by: danielehc <40759828+danielehc@users.noreply.github.com> Co-authored-by: Aimee Ukasick <aimee.ukasick@hashicorp.com> Co-authored-by: Tu Nguyen <im2nguyen@gmail.com> Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com>
4 tasks
boruszak
added a commit
that referenced
this pull request
May 5, 2025
Consul Documentation restructure according to IA & content strategy (#22041) * migration * nav fixes * nav * Missing top-level pages * nav/content alignment * partial path update * Partial fixes * Partial updates * partial paths * erroneous replacement fix * 3 page migration (test) * /agent migration * CA, cluster peering, & config entries * connect -> Gateways * connect * connect * nav * Dynamic app config * ecs * Tutorials -> docs * Tutorials moved * Updated nav with tutorials in docs * enterprise, install, and k8s through k8s/connect * k8s deployment * finished k8s migration * lambda, nia, nomad * nav fixes * security and discovery * service & upgrade * final page migrations * Nav update * Change navigation and page placement * Revert "Change navigation and page placement" This reverts commit 0934235. * Change navigation and page placement * Fixed broken include. * Updated sync consul service catalog with aws cloud map page. * Update to match page use of cloud map - AWS separates the two words. * Updated register services into a namespace docs page. * Updated explore the consul ui page. * Refactor HAProxy tutorial into usage doc * re-org * architecture and fundamentals * duplicate page deleted * Apply suggestions from code review * Moved consul-aws cli reference to its own page. * partial fix * Fix links and next steps * install and dev mode pages * CodeBlocks * env var page * title changes * Aligning with tracker * nav fixes * tracking alignment * Nav fixes * content checker fixed * Partial path fixes * more partial fixes * remove v2 reference * nav/title adjustments * first 64 find and replaces * /connect and /consul-vs-other * through /nia * finish docs paths * tutorial link paths * Redirects * Redirect updates * another tutorials redirect fix * link path updates * security architecture * Raft backend architecture * Deploy Consul overview * Fixes to redirect tests * Redirects * More redirect fixes * Updated link path replacements * README draft * README * More readme * Readme * Deploy server overview * Deploy client agents and dataplanes * cloud auto join page move * Manage Consul * Clean up * Consul template structure and first content * page name and filepath changes * Index updates * typo * VMs index page * Consul template documentation * disaster recovery and openshift guides (#11) * docs: disaster recovery * docs: openshift * adding OpenShift Local to CRC naming convention * Openshift page restructure * add redundancy-zones link * update openshift guide versions * /connect * /connect/vm * /connect/k8s * /fundamentals/cli * /fundamentals/cli and /register/service/nomad * /fundamentals/api * /fundamentals/editions (and remove env-var) * /fundamentals/tf and finish /fundamentals/editions * /fundamentals/identity * Fixes for working preview * Fundamentals updates * Agent page updates * Agent reference restructure * Redirects update * CT config * References with links and defaults * Some workflow fixes * Fix some links and images * Gossip and TLS with vault first changes * Gossip and TLS with vault first changes * Replace consul.io for URL deprecation * Bug Bash fixes * More bug bash fixes * nav fix * Final bug bash fixes * Vault TLS consul-template * Name the tool Consul Template * Move auto_config in config reference * Fix links * Updates to architecture * Architecture and use case updates * QoL improvements * Apply suggestions from code review * Glossary improvements * Updates * README updates * Finetuning * final readme updates * Link path changes to fix 500 errors * linkcheck fixes round 2 * round 3 500 error fixes * Errors fixes round 4 * CE-827: adding k8s and openshift tshoot info * Revert "CE-827: adding k8s and openshift tshoot info" This reverts commit a02f21d. * Redhat category rename * Readme updates * CE-846 content and screenshots * Ref/agent remove index; add auto-config file * Fix broken links due to configuration-file dir * CE-851 content and images * Fix content-check errors * lock update + move autopilot * v1.21 updates & release notes * IA/Content strategy readme finalizations * Inline image fix * real img fix * More README + consul.d in agent fundamentals * reviewed dataplane architecture content * review rest of completed drafts in arch * persona/directory index * reviewed fundamentals * Readme toc and final updates * re-order some sections * Final toc for readme * move inline examples to Example section where it made sense. * Ce-835: DNS views (#16) * CE-835 DNS forwarding in OpenShift * CE-835 DNS views in OpenShift * Apply suggestions from code review --------- * CE-827: Troubleshoot OpenShift (#17) * CE-827: adding k8s and openshift tshoot info * CE-827: adding openshift import-image info * CE-827: import-image timeout * Apply suggestions from code review --------- * CE-833: OpenShift page updates (#18) * CE-833: updater versions * Apply suggestions from code review --------- * CE-825: Consul on OpenShift Index Page (#19) * CE-825: Consul on OpenShift Index Page * Apply suggestions from code review --------- * telemetry * configuration file index * ESM and release notes updates * Apply suggestions from code review * Apply suggestions from code review * fixes for content check * partial fix * Merge resolution changes * Agent: Fix remaining links to reference/agent# * Copy edits * Update HAProxy load balance guide * review manage/dns * multi-tenant/sameness-group/vm * multi-tenant/samenessgroup/k8s * secure * deploy * CE-834: Upgrade OpenShift (#25) * upgrade openshift deployment * openshift: improve upgrade article * openshift: add redhat word to openshift term * Apply suggestions from code review * revision after code review --------- * Cleanup, especially Agent references * content fixes * Error fix --------- Co-authored-by: Daniele Carcasole <daniele@daniele-tt72xnn9y7.homenet.telecomitalia.it> Co-authored-by: danielehc <daniele@hashicorp.com> Co-authored-by: Anthony <russo555@gmail.com> Co-authored-by: Krastin Krastev <krastin@hashicorp.com> Co-authored-by: danielehc <40759828+danielehc@users.noreply.github.com> Co-authored-by: Aimee Ukasick <aimee.ukasick@hashicorp.com> Co-authored-by: Tu Nguyen <im2nguyen@gmail.com> Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com>
boruszak
added a commit
that referenced
this pull request
May 22, 2025
* Initialise release for consul 1.21 (#22195) * Init release 1.21 * Create nightly-test-integrations-1.21.x.yml * Remove comma * Upgrade go version to 1.23 (#22204) * Upgrade go version * Added changelog * Update config.deepcopy.go * Update .golangci.yml * fix lint * security: Upgrade crypto, oauth, go-jose (#22207) * Upgrade crypto to 0.35.0 * Upgrade oauth and go-jose * upgrade oauth and jose * Added changelog * Add the missing Service TaggedAddresses and Check Type fields to Txn API (#22220) * Add the missing Service TaggedAddresses and Check Type fields to Txn API * added changelog * [Feature] Invalidate session check if associated session is deleted (#22227) * Add session health check management and tests * Refactor session health check management and update related tests * Cleanup --------- Co-authored-by: srahul3 <rahulsharma@hashicorp.com> * build(deps): bump go version to go1.23.7 (#22237) * build(deps): bump go version to go1.24.1 * update: use 1.23.7 instead * add changelog * Fixes a couple of DNS token example commands (#22224) * Fixes a couple of example commands The `-name` option is not available `-description` is used in it's place. set-agent-token is a sub-command of the acl command. * This feature works with federated services only This command does not work with peered clusters so needs to be clarified. * Refactor Txn API to use AgentService and add TaggedAddresses support (#22248) * Add the missing Service TaggedAddresses and Check Type fields to Txn API * added changelog * Refactor Txn API to use AgentService and add TaggedAddresses support * Document Azure service principal auth in snapshot/agent.mdx (#21942) * Update agent.mdx Starting from Consul v1.20.1+ent, Consul supports using Azure Blob Storage for the snapshot agent via Azure Service Principal ID and Secret authentication. I've successfully tested this configuration in my lab environment and have added the relevant parameters to this documentation for completeness. * Update website/content/commands/snapshot/agent.mdx Co-authored-by: Blake Covarrubias <blake@covarrubi.as> * Update website/content/commands/snapshot/agent.mdx Co-authored-by: Blake Covarrubias <blake@covarrubi.as> * Update website/content/commands/snapshot/agent.mdx Co-authored-by: Blake Covarrubias <blake@covarrubi.as> * Update website/content/commands/snapshot/agent.mdx Co-authored-by: Blake Covarrubias <blake@covarrubi.as> --------- Co-authored-by: Blake Covarrubias <blake@covarrubi.as> * Fix catalog service endpoint when querying for a peer service (#22189) * Fix catalog service endpoint when querying for a peer service * Add changelog file * Add changes to docs. Add test * Update website/content/api-docs/catalog.mdx Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> --------- Co-authored-by: Sreeram Narayanan <sreeram.narayanan@hashicorp.com> Co-authored-by: nitin-sachdev-29 <nitin.sachdev@hashicorp.com> Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * Update lock.mdx (Node Health Check and TTL) (#22258) * Update lock.mdx (Node Health Check and TTL) Consul `lock` command update that captures why consul lock can act indefinitely when node checks are in place and how users can work around it by creating/managing their own session. * Update website/content/commands/lock.mdx Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * CVE Fix (#22268) * Fixed following CVEs: GHSA-vvgc-356p-c3xw in golang.org/x/net@v0.37.0 GO-2025-3595 in golang.org/x/net@v0.37.0 GO-2025-3553 in github.com/golang-jwt/jwt/v4@v4.5.1 GHSA-mh63-6h87-95cp in github.com/golang-jwt/jwt/v4@v4.5.1 stdlib in Go GO-2025-3563@1.23.7 * added changelog * Upgraded go to 1.23.8 (#22273) * Fixed following CVEs: GHSA-vvgc-356p-c3xw in golang.org/x/net@v0.37.0 GO-2025-3595 in golang.org/x/net@v0.37.0 GO-2025-3553 in github.com/golang-jwt/jwt/v4@v4.5.1 GHSA-mh63-6h87-95cp in github.com/golang-jwt/jwt/v4@v4.5.1 stdlib in Go GO-2025-3563@1.23.7 * added changelog * upgraded go to 1.23.8 * suppressing alpine CVEs as there is no fix yet (#22278) * feature: Adding configurable value to disable XDS Load balancing feature: Adding configurable value to disable XDS Load balancing Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * Go discover dependency upgrade (#22313) * suppressing staticcheck lint warning * upgraded hashicorp/go-discover to 1.0.0 version * generated proto files * Update iframe to VideoEmbed (#22302) update iframe to videoembed * Consul Documentation restructure according to IA & content strategy (#22041) * migration * nav fixes * nav * Missing top-level pages * nav/content alignment * partial path update * Partial fixes * Partial updates * partial paths * erroneous replacement fix * 3 page migration (test) * /agent migration * CA, cluster peering, & config entries * connect -> Gateways * connect * connect * nav * Dynamic app config * ecs * Tutorials -> docs * Tutorials moved * Updated nav with tutorials in docs * enterprise, install, and k8s through k8s/connect * k8s deployment * finished k8s migration * lambda, nia, nomad * nav fixes * security and discovery * service & upgrade * final page migrations * Nav update * Change navigation and page placement * Revert "Change navigation and page placement" This reverts commit 0934235. * Change navigation and page placement * Fixed broken include. * Updated sync consul service catalog with aws cloud map page. * Update to match page use of cloud map - AWS separates the two words. * Updated register services into a namespace docs page. * Updated explore the consul ui page. * Refactor HAProxy tutorial into usage doc * re-org * architecture and fundamentals * duplicate page deleted * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * Moved consul-aws cli reference to its own page. * partial fix * Fix links and next steps * install and dev mode pages * CodeBlocks * env var page * title changes * Aligning with tracker * nav fixes * tracking alignment * Nav fixes * content checker fixed * Partial path fixes * more partial fixes * remove v2 reference * nav/title adjustments * first 64 find and replaces * /connect and /consul-vs-other * through /nia * finish docs paths * tutorial link paths * Redirects * Redirect updates * another tutorials redirect fix * link path updates * security architecture * Raft backend architecture * Deploy Consul overview * Fixes to redirect tests * Redirects * More redirect fixes * Updated link path replacements * README draft * README * More readme * Readme * Deploy server overview * Deploy client agents and dataplanes * cloud auto join page move * Manage Consul * Clean up * Consul template structure and first content * page name and filepath changes * Index updates * typo * VMs index page * Consul template documentation * disaster recovery and openshift guides (#11) * docs: disaster recovery * docs: openshift * adding OpenShift Local to CRC naming convention * Openshift page restructure * add redundancy-zones link * update openshift guide versions Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> Co-authored-by: boruszak <jeffrey.boruszak@hashicorp.com> Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * /connect * /connect/vm * /connect/k8s * /fundamentals/cli * /fundamentals/cli and /register/service/nomad * /fundamentals/api * /fundamentals/editions (and remove env-var) * /fundamentals/tf and finish /fundamentals/editions * /fundamentals/identity * Fixes for working preview * Fundamentals updates * Agent page updates * Agent reference restructure * Redirects update * CT config * References with links and defaults * Some workflow fixes * Fix some links and images * Gossip and TLS with vault first changes * Gossip and TLS with vault first changes * Replace consul.io for URL deprecation * Bug Bash fixes * More bug bash fixes * nav fix * Final bug bash fixes * Vault TLS consul-template * Name the tool Consul Template * Move auto_config in config reference * Fix links * Updates to architecture * Architecture and use case updates * QoL improvements * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * Glossary improvements * Updates * README updates * Finetuning * final readme updates * Link path changes to fix 500 errors * linkcheck fixes round 2 * round 3 500 error fixes * Errors fixes round 4 * CE-827: adding k8s and openshift tshoot info * Revert "CE-827: adding k8s and openshift tshoot info" This reverts commit a02f21d. * Redhat category rename * Readme updates * CE-846 content and screenshots * Ref/agent remove index; add auto-config file * Fix broken links due to configuration-file dir * CE-851 content and images * Fix content-check errors * lock update + move autopilot * v1.21 updates & release notes * IA/Content strategy readme finalizations * Inline image fix * real img fix * More README + consul.d in agent fundamentals * reviewed dataplane architecture content * review rest of completed drafts in arch * persona/directory index * reviewed fundamentals * Readme toc and final updates * re-order some sections * Final toc for readme * move inline examples to Example section where it made sense. * Ce-835: DNS views (#16) * CE-835 DNS forwarding in OpenShift * CE-835 DNS views in OpenShift * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * CE-827: Troubleshoot OpenShift (#17) * CE-827: adding k8s and openshift tshoot info * CE-827: adding openshift import-image info * CE-827: import-image timeout * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * CE-833: OpenShift page updates (#18) * CE-833: updater versions * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * CE-825: Consul on OpenShift Index Page (#19) * CE-825: Consul on OpenShift Index Page * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * telemetry * configuration file index * ESM and release notes updates * Apply suggestions from code review Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com> * fixes for content check * partial fix * Merge resolution changes * Agent: Fix remaining links to reference/agent# * Copy edits * Update HAProxy load balance guide * review manage/dns * multi-tenant/sameness-group/vm * multi-tenant/samenessgroup/k8s * secure * deploy * CE-834: Upgrade OpenShift (#25) * upgrade openshift deployment * openshift: improve upgrade article * openshift: add redhat word to openshift term * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * revision after code review --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> * Cleanup, especially Agent references * content fixes * Error fix --------- Co-authored-by: Daniele Carcasole <daniele@daniele-tt72xnn9y7.homenet.telecomitalia.it> Co-authored-by: danielehc <daniele@hashicorp.com> Co-authored-by: Anthony <russo555@gmail.com> Co-authored-by: Krastin Krastev <krastin@hashicorp.com> Co-authored-by: danielehc <40759828+danielehc@users.noreply.github.com> Co-authored-by: Aimee Ukasick <aimee.ukasick@hashicorp.com> Co-authored-by: Tu Nguyen <im2nguyen@gmail.com> Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com> * feature: add LUA script Envoy extension support for API gateway (#22321) * docs: Lua page fix (#22338) Missing <CodeBlockConfig> added * update: remove 1.15 as LTS, remove1.20 as CE (#22341) * Update version compatibility matricies for v1.21.x (#22328) * table to partial conversion plus updates * k8s version update --------- Co-authored-by: Abhishek Sahu <abhishek.sahu@hashicorp.com> Co-authored-by: nitin-sachdev-29 <nitin.sachdev@hashicorp.com> Co-authored-by: Rahul <srahul3@gmail.com> Co-authored-by: srahul3 <rahulsharma@hashicorp.com> Co-authored-by: Deniz Onur Duzgun <59659739+dduzgun-security@users.noreply.github.com> Co-authored-by: Nick Wales <588472+nickwales@users.noreply.github.com> Co-authored-by: SuyashHashiCorp <92308220+SuyashHashiCorp@users.noreply.github.com> Co-authored-by: Blake Covarrubias <blake@covarrubi.as> Co-authored-by: Jorge Marey <6938602+jorgemarey@users.noreply.github.com> Co-authored-by: Sreeram Narayanan <sreeram.narayanan@hashicorp.com> Co-authored-by: natemollica-dev <57850649+natemollica-nm@users.noreply.github.com> Co-authored-by: Vikramarjuna <vkrmrjun@gmail.com> Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com> Co-authored-by: Daniele Carcasole <daniele@daniele-tt72xnn9y7.homenet.telecomitalia.it> Co-authored-by: danielehc <daniele@hashicorp.com> Co-authored-by: Anthony <russo555@gmail.com> Co-authored-by: Krastin Krastev <krastin@hashicorp.com> Co-authored-by: danielehc <40759828+danielehc@users.noreply.github.com> Co-authored-by: Aimee Ukasick <aimee.ukasick@hashicorp.com> Co-authored-by: Tu Nguyen <im2nguyen@gmail.com>
4 tasks
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
This PR updates the Consul documentation to refresh its structure according to a defined information architecture (IA) and content strategy.
There are three components to this documentation restructure. They exist as a complementary set and cannot be implemented individually.
website/contentthat formally defines Consul in relation to the documentation structure. This document declares a product taxonomy for Consul and controls vocabulary to standardize content.Advantages of this information architecture
Mental model improvements. This IA is designed to make Consul less complicated for existing users and easier for new users to learn. It organizes the documentation according to the type of content so that explanations, usage instructions, and reference documentation are more rigorously maintained as discrete categories. The IA and content strategy README also includes explicit definitions for terms in a product taxonomy and controlled vocabularies. These assets “map” where the product runs to better articulate Consul’s control plane and data plane operations alongside application infrastructure, and the IA adopts the cardinal directions to describe Consul’s network operations as occurring in north/south and east/west directions. Sequencing usage phases that are divided into “Consul operations” and “service networking” categories provides additional clarity for product operations to support a user’s ability to build a “mental model” of Consul. This mental model advances the level of educational objectives we can achieve according to Bloom’s taxonomy by providing a foundation for users to more effectively “apply” and “analyze” what they learn about Consul.
Modularity and interoperability. This information architecture and content strategy apply the Diataxis framework for technical documentation to our defined product personas, jobs-to-be-done, and critical user journeys. The result is a more modular approach to product documentation that leverages recognized strategies and workflows for producing maintainable content. And even though it was designed for a docs-as-code workflow, the IA includes a taxonomy that makes exporting to other frameworks relatively straightforward. For example, moving to Darwin Type Information Architecture (DITA), or migrating to a dedicated Content Management System (CMS), would not require significant redesign effort because the directory and file naming schema converts directly into the topic “tags” that these other systems require, while the README index taxonomic categories to one another.
Google SEO improvements. Previous efforts to improve our content’s Google SEO focused on rewriting page descriptions, expanding the capabilities of DevDot’s search capabilities, and addressing 4xx and 5xx errors on the site to patch known problems. But according to Google’s SEO guide on site organization, breadcrumbs represented by the URL structure play an outsized role in content SEO, to the point where Google provides best practices for structuring URLs. Following these best practices to structure our data is the part of the SEO equation that we can affect most directly, and represents the highest effort/highest impact changes we can make to improve our performance on Google Search.
Deployment preview
Stable deployment preview
PR Checklist