move guides into versioned documentation

[skriss]

Closes #4396.

Couple notes:

• The versioned guides exist in "main" and "v1.23.2" docs only
• I updated the top-level site header nav: Guides is no longer listed there, and Documentation moved left to be more prominent. Guides are now in the documentation TOC.
• I left the existing non-versioned guides in place to avoid breaking old links, but I updated as many links as I could find (i.e. from the versioned docs) to point to the new versioned guides
• I deleted a few guides that were no longer relevant

Still clicking around to make sure I didn't break anything.

Preview site: https://deploy-preview-4977--projectcontour.netlify.app/

[skriss]

One thing I don't like is how long the nav/TOC is getting for docs, it just makes it hard to navigate. Would be nice to have the sections within the TOC be collapsible. ref. #3815

[codecov]

Codecov Report

Merging #4977 (75cec94) into main (63dd999) will decrease coverage by 0.00%.
The diff coverage is n/a.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4977      +/-   ##
==========================================
- Coverage   77.61%   77.60%   -0.01%     
==========================================
  Files         140      140              
  Lines       16871    16875       +4     
==========================================
+ Hits        13094    13096       +2     
- Misses       3520     3522       +2     
  Partials      257      257              

Impacted Files	Coverage Δ
internal/sorter/sorter.go	97.95% <0.00%> (-0.52%)	⬇️
cmd/contour/serve.go	22.31% <0.00%> (-0.04%)	⬇️
pkg/config/parameters.go	86.61% <0.00%> (ø)
internal/envoy/v3/ratelimit.go	100.00% <0.00%> (ø)
internal/xdscache/v3/listener.go	91.33% <0.00%> (+0.02%)	⬆️
cmd/contour/servecontext.go	80.91% <0.00%> (+0.05%)	⬆️

[skriss]

I think this is looking pretty good, marked ready for review.

[sunjayBhatia]

the deploy preview looks great 👍🏽

looked through the commits as well, seems like you caught all the cross-page links

might be a good time to reenable or at least rerun the link checker for this change

[skriss]

might be a good time to reenable or at least rerun the link checker for this change

Yeah didn't that break with the migration to Hugo? Will have to look and see if there's something we can use, agreed it would be a nice check to have.

[sunjayBhatia]

might be a good time to reenable or at least rerun the link checker for this change

Yeah didn't that break with the migration to Hugo? Will have to look and see if there's something we can use, agreed it would be a nice check to have.

yep i think that was around the time it was disabled

[sunjayBhatia]

might be a good time to reenable or at least rerun the link checker for this change

Yeah didn't that break with the migration to Hugo? Will have to look and see if there's something we can use, agreed it would be a nice check to have.

I'm cool with merging and doing another link check on the side and fixing things in another PR! (if there is anything to fix)

[skriss]

Sounds good, will merge and then find a link checker to use.