docs: Reference pages for service-router and service-resolver config entries#17145
Conversation
boruszak
left a comment
There was a problem hiding this comment.
Leaving questions on some specific items for verification from engineering SMEs.
eddie-rowe
left a comment
There was a problem hiding this comment.
Looks good overall to me.
Grateful for the directed comments - made it very accessible to contribute.
trujillo-adam
left a comment
There was a problem hiding this comment.
I didn't get 100% through everything but most of this looks really good. We should discuss it next week, but I think the decision to use tables for large sections of configuration parameters is, to some extent, conflicting with the format we are trying to establish. We discussed it earlier, but I was under the impression that the tables would be more the exception than the rule.
| - Default: None | ||
| - Data type: Map containing one or more of the following parameters: | ||
|
|
||
| | Parameter | Description | Data type | Default | |
There was a problem hiding this comment.
| | Parameter | Description | Data type | Default | | |
| | Parameter | Description | Data type | Default | |
I think these params are better served as their own entries in the specification. Including the reason I mentioned in another comment about the control+f workflow, it also breaks the configuration model. We tell readers to click on a parameter to view it's details and the links to these parameters don't work. We could just link them all to #routes-destination, but I think it's a little counter to the spirit of the format we're trying to establish. For lower-nested configurations, it totally makes sense to place them into a table and link to the parent param, as in the Add, Set, Remove maps in the RequestHeaders and ResponseHeaders fields. But I think this is too much of a deviation from the format.
trujillo-adam
left a comment
There was a problem hiding this comment.
Looks great! I just saw one typo and had one suggestion about linking to an example from one of the params in the resolver spec. Also, we are only using the curly braces in the HCL headings because there isn't a shorthand for maps in YAML, correct?
Co-authored-by: trujillo-adam <47586768+trujillo-adam@users.noreply.github.com>
…entries (#17145) * service-resolve configuration entry reference * Updates * missing backtick * service router configuration entry reference * link fixes + tab fixes * link and tab fixes * link fixes * service resolver improvements * hierarchy fixes * spacing * links + formatting * proofing fixes * mmore fixes * Apply suggestions from code review suggestions from code review for service resolver Co-authored-by: trujillo-adam <47586768+trujillo-adam@users.noreply.github.com> * policy sections edits * service router code review * Tables to sections - service router HCL * YAML tables to sections * formatting fixes * converting tables to sections - service resolver * final tables to sections * Adjustments/alignments * nanosecond fix * Update website/content/docs/connect/config-entries/service-router.mdx Co-authored-by: trujillo-adam <47586768+trujillo-adam@users.noreply.github.com> * link to filter example config --------- Co-authored-by: trujillo-adam <47586768+trujillo-adam@users.noreply.github.com>
…lver config entries into release/1.15.x (#17397) * no-op commit due to failed cherry-picking * docs: Reference pages for service-router and service-resolver config entries (#17145) * service-resolve configuration entry reference * Updates * missing backtick * service router configuration entry reference * link fixes + tab fixes * link and tab fixes * link fixes * service resolver improvements * hierarchy fixes * spacing * links + formatting * proofing fixes * mmore fixes * Apply suggestions from code review suggestions from code review for service resolver Co-authored-by: trujillo-adam <47586768+trujillo-adam@users.noreply.github.com> * policy sections edits * service router code review * Tables to sections - service router HCL * YAML tables to sections * formatting fixes * converting tables to sections - service resolver * final tables to sections * Adjustments/alignments * nanosecond fix * Update website/content/docs/connect/config-entries/service-router.mdx Co-authored-by: trujillo-adam <47586768+trujillo-adam@users.noreply.github.com> * link to filter example config --------- Co-authored-by: trujillo-adam <47586768+trujillo-adam@users.noreply.github.com> * Update website/content/docs/connect/config-entries/service-resolver.mdx * merge fix --------- Co-authored-by: temp <temp@hashicorp.com> Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> Co-authored-by: trujillo-adam <47586768+trujillo-adam@users.noreply.github.com> Co-authored-by: boruszak <jeffrey.boruszak@hashicorp.com>
Description
This PR updates the service resolver and service router configuration entry reference pages as part of the Consul Education team's IA efforts. These changes restructure the page to make information easier to find, and to promote a consistent layout between reference pages.
PR Checklist