search

SteeltoeOSS / MainSite

This repository is used for building the steeltoe.io website, along with the Getting Started guides. The docs portion is in the Documentation repository.
https://steeltoe.io
Apache License 2.0
8 stars 6 forks source link

Fix broken links and site nav glitch, misc cleanup #141

Closed TimHess closed 9 months ago

TimHess commented 10 months ago

Fixes #140

bart-vmware commented 10 months ago

Trying to run the site, I noticed the links between the main site and docs site now diverge, which looks confusing. Can you sync them up instead of removing entries on the main site?

Also, clicking Why Steeltoe > Overview from the docs site returns a 404 because it redirects to http instead of https. Steps to reproduce:

TimHess commented 10 months ago

In testing the combination of this PR with SteeltoeOSS/Documentation#310, I found the following:

  1. Menu entry Projects > Steeltoe Dynamic Logging has disappeared from both sites. When I asked to sync them up, I meant to fix the title/link to be consistent between both sides; not remove the entry altogether.

  2. MainSite > Projects > Steeltoe Network File Sharing: throws exception when clicked

    • Note the link from Documentation is named differently ("Steeltoe Network File Shares") and points to a different URL
    • Same issue for the link in footer

  3. Documentation: Make the browser window smaller, so the top-level menu changes into a hamburger menu. Then clicking the hamburger menu shortly expands its entries before auto-collapsing again. It's currently impossible to keep it visible. It works properly on MainSite.

  4. MainSite: when the site loads, two errors appear in the console:

  5. Documentation: navigate to /api/v3/stream/, the following errors show in the console:

  6. Documentation > Get started > API Browser: left-side version-selector panel with namespaces does not appear

  1. added back
  2. changed links to point to docs site, also added route handling to page that handles redirects for any old/missed link
  3. still working on this
  4. I believe those are from an ad blocker in your browser
  5. resolved
  6. haven't started but will look to make changes that easily merge with this commit
github-actions[bot] commented 10 months ago

Preview link: https://www-steeltoe-pr-141.azurewebsites.net

This is an automated message.

bart-vmware commented 9 months ago

In testing the combination of this PR with SteeltoeOSS/Documentation#310, I found the following:

  1. Menu entry Projects > Steeltoe Dynamic Logging has disappeared from both sites. When I asked to sync them up, I meant to fix the title/link to be consistent between both sides; not remove the entry altogether.
  2. MainSite > Projects > Steeltoe Network File Sharing: throws exception when clicked
  • Note the link from Documentation is named differently ("Steeltoe Network File Shares") and points to a different URL
  • Same issue for the link in footer

  1. Documentation: Make the browser window smaller, so the top-level menu changes into a hamburger menu. Then clicking the hamburger menu shortly expands its entries before auto-collapsing again. It's currently impossible to keep it visible. It works properly on MainSite.

  2. MainSite: when the site loads, two errors appear in the console:

  3. Documentation: navigate to /api/v3/stream/, the following errors show in the console:

  4. Documentation > Get started > API Browser: left-side version-selector panel with namespaces does not appear

  1. added back
  2. changed links to point to docs site, also added route handling to page that handles redirects for any old/missed link
  3. still working on this
  4. I believe those are from an ad blocker in your browser
  5. resolved
  6. haven't started but will look to make changes that easily merge with this commit
  1. Another "Uncaught TypeError" script error now appears (at https://docs-steeltoe-pr-310.azurewebsites.net/api/v3/stream/): image