fix: docs UI improvements — navbar link, heading styles, footer layout, banner

[slayerjain]

Summary

• Navbar fix: Updated Products > Integration Testing link from server/installation to server/install
• Top gap removed: Zeroed out docusaurus-mt-lg margin and changed article wrapper from my-12 to mb-12
• Announcement bar: Fixed CSS selector (class^= -> class*=) so styles apply; added striped light orange background with catchier copy
• Heading colors: Changed h1/h2 from washed-out black to brand dark blue (#00163D), h3/h4 to #0a2a5e
• V3 emoji cleanup: Removed emojis from all 25 h1 headings in version-3.0.0 docs
• Footer layout: Footer uses margin-left: var(--doc-sidebar-width) on desktop to stay aligned with content area across all breakpoints
• SEO (from base branch): Glossary frontmatter updates, showLastUpdateAuthor/Time enabled, noindex headers for deprecated doc versions
• robots.txt fix: Removed Disallow for /docs/1.0.0/ and /docs/2.0.0/ so crawlers can see the noindex header

Test plan

• Click Integration Testing under Products in navbar - should go to /docs/server/install
• Verify no gap between navbar and breadcrumbs on doc pages
• Verify announcement bar has striped orange background (not plain white)
• Verify h1/h2 headings are dark blue, not black
• Check v3 docs h1s have no emojis
• Verify footer aligns with content area and does not extend under sidebar at all breakpoints
• Check mobile layout - footer should be full-width when sidebar is hidden

Generated with Claude Code

[Copilot]

Pull request overview

This PR updates the Docusaurus docs site navigation and SEO/indexing configuration, primarily to fix the Products → Integration Testing navbar link so it points to the correct /install route.

Changes:

• Fix the navbar “Integration Testing” link to route to install (i.e., /docs/install).
• Update multiple glossary doc frontmatter titles/descriptions (SEO-oriented metadata changes).
• Add noindex/no-crawl handling for deprecated doc versions (/docs/1.0.0/, /docs/2.0.0/) and enable “last updated” author/time display in docs.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
versioned_docs/version-4.0.0/concepts/reference/glossary/white-box-testing.md	Update frontmatter title/description.
versioned_docs/version-4.0.0/concepts/reference/glossary/unit-testing.md	Update frontmatter title/description.
versioned_docs/version-4.0.0/concepts/reference/glossary/regression-testing.md	Update frontmatter title/description.
versioned_docs/version-4.0.0/concepts/reference/glossary/performance-testing.md	Update frontmatter title/description.
versioned_docs/version-4.0.0/concepts/reference/glossary/mocks.md	Update frontmatter title/description.
versioned_docs/version-4.0.0/concepts/reference/glossary/load-testing.md	Update frontmatter title/description.
versioned_docs/version-4.0.0/concepts/reference/glossary/integration-testing.md	Update frontmatter title/description.
versioned_docs/version-4.0.0/concepts/reference/glossary/idempotency.md	Update frontmatter title/description.
versioned_docs/version-4.0.0/concepts/reference/glossary/code-coverage.md	Update frontmatter title/description.
versioned_docs/version-4.0.0/concepts/reference/glossary/black-box-testing.md	Update frontmatter title/description.
static/robots.txt	Disallow crawling deprecated doc versions.
netlify.toml	Add X-Robots-Tag headers to noindex deprecated doc versions.
docusaurus.config.js	Fix navbar link to install; enable last updated author/time display.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

This PR changes more than the described navbar fix: it also enables showLastUpdateAuthor/showLastUpdateTime (site-wide UI/behavior change) and includes unrelated SEO/indexing changes in other files. Please update the PR title/description (or split into separate PRs) so reviewers can assess each change with the right context and test plan.

[slayerjain]

Updated the PR title and description to cover all changes including the SEO/indexing work and showLastUpdateAuthor/Time (carried from the base branch).

[Copilot]

robots.txt is disallowing /docs/1.0.0/ and /docs/2.0.0/ while the PR also adds X-Robots-Tag: noindex headers for those paths. For crawlers that honor robots.txt, the Disallow can prevent them from fetching the pages and seeing the noindex header, which can undermine the de-indexing goal. Consider removing these Disallow rules (or otherwise ensuring crawlers can see the noindex directive) if the intent is to keep the pages accessible but not indexed.

Suggested change

	Disallow: /docs/1.0.0/
	Disallow: /docs/2.0.0/

[slayerjain]

Fixed — removed the Disallow rules for /docs/1.0.0/ and /docs/2.0.0/ from robots.txt so crawlers can reach the pages and honor the X-Robots-Tag: noindex header for proper de-indexing.

[Copilot]

Pull request overview

Copilot reviewed 28 out of 28 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (1)

docusaurus.config.js:1

• "to: "install""will navigate to/install(site root) rather than/docs/installon a typical Docusaurus setup (and the PR description/test plan explicitly expects/docs/install). Prefer using an absolute docs path (e.g., /docs/install) or use a Docusaurus docs navbar item (type: "doc", docId: "install") so the link remains correct even if routeBasePath` changes.

//@ts-check

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

This unconditional margin-left: 260px !important; rule is declared after the responsive footer rules above (including the mobile reset), so it will override them in the cascade when selectors have similar specificity—preventing the breakpoint-specific margin-left values (and the <=996px reset to 0) from taking effect. Move the base footer offset rule earlier (before the breakpoint overrides), or re-declare the breakpoint-specific footer rules after this block, so mobile and other breakpoints can correctly control the footer alignment.

Suggested change

	/* On doc pages, offset footer so it doesn't overlap sidebar */
	.plugin-docs .theme-layout-footer.footer,
	.docs-wrapper ~ .theme-layout-footer.footer,
	[class*="docsWrapper"] ~ footer,
	.plugin-docs footer.footer {
	margin-left: 260px !important;
	/* On doc pages, offset footer so it doesn't overlap sidebar on desktop only */
	@media (min-width: 997px) {
	.plugin-docs .theme-layout-footer.footer,
	.docs-wrapper ~ .theme-layout-footer.footer,
	[class*="docsWrapper"] ~ footer,
	.plugin-docs footer.footer {
	margin-left: 260px !important;
	}

[slayerjain]

Good catch — wrapped the base footer offset in @media (min-width: 997px) so it only applies on desktop and doesn't fight with the breakpoint-specific rules. Also removed the now-redundant mobile reset block.

[Copilot]

Pull request overview

Copilot reviewed 30 out of 31 changed files in this pull request and generated 3 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

@import rules must appear before any non-@charset style rules. Here the Google Fonts @import comes after regular selectors (lines 1-6), which can cause the import to be ignored by the browser. Move the font import to the very top of the file (or load the font via a <link rel="preload/stylesheet"> in headTags) so DM Sans is reliably applied.

[slayerjain]

Fixed — moved the @import for Google Fonts to the very top of custom.css so it precedes all style rules.

[Copilot]

The desktop footer offset rule (margin-left: 260px) is declared after the breakpoint-specific footer offsets (e.g., 180px/200px/280px). On widths where both media queries match, this later rule will win in the cascade and effectively disable the breakpoint-specific values. Consider either (a) using a single margin-left: var(--doc-sidebar-width) (since you already set --doc-sidebar-width), or (b) moving this base rule earlier and keeping the more specific breakpoint rules after it.

Suggested change

	margin-left: 260px !important;
	margin-left: var(--doc-sidebar-width, 260px) !important;

[slayerjain]

Fixed — replaced all hardcoded margin-left values with var(--doc-sidebar-width, 260px) in a single desktop-scoped rule. The CSS variable is now updated at each breakpoint alongside the sidebar width, so the footer tracks automatically.

[Copilot]

PR description/test plan says the navbar should route to /docs/install, but the actual navbar target is server/install (which will resolve to /server/install under routeBasePath: "/", plus the site baseUrl). To avoid confusion for reviewers, align the description/test plan with the actual route (or adjust this to value if /install is the intended URL).

[slayerjain]

Fixed — updated the PR description to say /docs/server/install to match the actual to: "server/install" navbar target.

[Copilot]

Pull request overview

Copilot reviewed 30 out of 31 changed files in this pull request and generated 2 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The Docker Installation links in this table still point to /server/installation/, but in v3 the server installation doc route is /server/install (frontmatter id: install). This link will 404 unless you have explicit redirects—please update the table links to the correct route (and keep trailing slash consistent with trailingSlash: true).

[slayerjain]

Fixed — updated both Docker Installation links in the v3 platform-requirements table from /server/installation/ to /server/install/.

[Copilot]

This rule overrides .docusaurus-mt-lg globally. Since that class is a general Docusaurus spacing utility (not docs-specific), this can unintentionally remove top spacing on non-doc pages that use the same class. Consider scoping the margin override to docs pages only (e.g., body[data-docs-root] .docusaurus-mt-lg or .plugin-docs .docusaurus-mt-lg).

[slayerjain]

Fixed — scoped the margin-top: 0 override to .plugin-docs .docusaurus-mt-lg so it only applies on doc pages. Non-doc pages retain the default Docusaurus spacing.

[Copilot]

Pull request overview

Copilot reviewed 31 out of 31 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (2)

src/css/custom.css:2824

• The @media (max-width: 1200px) block sets --doc-sidebar-width and forces .theme-doc-sidebar-container to 200px. Because this media query also matches mobile widths (<996px) and appears after the dedicated mobile sidebar rules, it can override the intended mobile width: 100% sidebar behavior. Consider scoping this breakpoint to desktop only (e.g., (min-width: 997px) and (max-width: 1200px)) or otherwise ensuring the mobile @media (max-width: 996px) rules win in the cascade.

/* Tablet breakpoint */
@media (max-width: 1200px) {
  [class*="tableOfContents"] {
    min-width: 140px;
    max-width: 180px;
    padding-left: 0.25rem;
    padding-right: 0.5rem;
    margin-right: 0;
  }

  .col.col--3 {
    --ifm-col-width: 180px !important;
    flex: 0 0 180px !important;
    max-width: 180px !important;
    padding-right: 0.75rem !important;
    padding-left: 0.25rem !important;
  }

  :root {
    --doc-sidebar-width: 200px !important;
  }

  .theme-doc-sidebar-container {
    width: 200px !important;
    min-width: 200px !important;
  }

src/css/custom.css:2862

• Similar to the 1200px breakpoint, this @media (max-width: 1100px) rule forces .theme-doc-sidebar-container to 180px and updates --doc-sidebar-width. Since it also matches mobile widths and comes after the @media (max-width: 996px) mobile sidebar rules, it can unintentionally override the mobile layout. Restrict this breakpoint to desktop widths (e.g., add min-width: 997px) or move mobile overrides after these blocks.

/* Medium screens */
@media (max-width: 1100px) {
  [class*="tableOfContents"] {
    min-width: 120px;
    max-width: 160px;
  }

  .col.col--3 {
    --ifm-col-width: 160px !important;
    flex: 0 0 160px !important;
    max-width: 160px !important;
    padding-right: 0.5rem !important;
  }

  :root {
    --doc-sidebar-width: 180px !important;
  }

  .theme-doc-sidebar-container {
    width: 180px !important;
    min-width: 180px !important;
  }

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[nehagup]

keep the messaging like previous ones.

[slayerjain]

Done — reverted the announcement bar text back to the original messaging.

[Copilot]

Pull request overview

Copilot reviewed 31 out of 31 changed files in this pull request and generated 1 comment.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The selector div[class*="announcementBar"] is very broad and will also match nested Announcement Bar elements whose class names include the same substring (e.g., content/close wrappers). That can unintentionally apply padding/borders/background to inner nodes and break layout. Consider narrowing the selector to the top-level Announcement Bar container only (for example by adding a more specific class token match or an attribute like [role="banner"], and/or explicitly excluding *Content*/close elements).

[slayerjain]

Fixed — narrowed the selector to div[class*="announcementBar"]:not([class*="Content"]):not([class*="Close"]) so it only targets the top-level container.

[Copilot]

Pull request overview

Copilot reviewed 31 out of 31 changed files in this pull request and generated 2 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Announcement bar links use color: #ff914d on a very light orange/near-white striped background. That combination is likely below WCAG contrast requirements, which can make the GitHub/Twitter links hard to read for some users. Consider using a darker link color (e.g., a darker brand orange) and/or only using orange on hover while keeping the default link text closer to the main bar text color.

[slayerjain]

Fixed — darkened link color from #ff914d to #c45a1a for WCAG contrast compliance on the light orange striped background. Hover is now #a0460f.

[Copilot]

Loading Google Fonts via CSS @import is render-blocking and can noticeably delay first paint on docs pages. Prefer adding a <link rel="preconnect">/<link rel="stylesheet"> in headTags (or self-hosting the font) and remove redundant imports (the repo also imports DM Sans in src/theme/DocItem/styles.module.css).

Suggested change

@import url("https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;700&display=swap");

[slayerjain]

Fixed — moved DM Sans loading to headTags in docusaurus.config.js with preconnect hints. Removed both CSS @import statements from custom.css and DocItem/styles.module.css.

[Copilot]

Pull request overview

Copilot reviewed 32 out of 32 changed files in this pull request and generated 1 comment.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The new DM Sans loading block is labeled as “non-render-blocking”, but a <link rel="stylesheet"> Google Fonts stylesheet is still render-blocking (just less problematic than CSS @import). If the intent is truly non-render-blocking, consider using a preload+onload swap (with noscript fallback) or self-hosting the font; otherwise, please adjust the comment so it doesn’t mislead future readers about the performance characteristics.

[slayerjain]

Fixed — updated the comment to accurately say "loaded via headTags instead of CSS @import" without the misleading "non-render-blocking" claim.

[Copilot]

Pull request overview

Copilot reviewed 32 out of 32 changed files in this pull request and generated 1 comment.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

--doc-sidebar-width is now used for footer alignment, but the sidebar width itself is still hard-coded elsewhere in this file (e.g., .theme-doc-sidebar-container { width: 260px; } and breakpoint overrides). That duplication can drift over time and break the footer alignment again. Consider using width/min-width: var(--doc-sidebar-width) for the sidebar container so the CSS variable remains the single source of truth across breakpoints.

[slayerjain]

Fixed — replaced all hardcoded width/min-width values on .theme-doc-sidebar-container with var(--doc-sidebar-width) so the CSS variable is the single source of truth across the base rule and all breakpoints.

[Copilot]

Pull request overview

Copilot reviewed 32 out of 32 changed files in this pull request and generated no new comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.