Merge har.fyi under docs by max-ostapenko · Pull Request #1332 · HTTPArchive/httparchive.org

max-ostapenko · 2026-09-14T19:39:12Z

This PR merges har.fyi content directly into httparchive.org under the /docs/ path:

Adds Astro Starlight integration (@astrojs/starlight, starlight-links-validator, starlight-llms-txt)
Migrates all guides, reference docs (tables, blobs, structs, custom metrics, functions), and assets into src/content/docs/
Integrates custom Starlight header matching HTTP Archive branding and search
Updates sitemap and timestamp generation to index doc pages
Updates site navigation and references pointing to har.fyi to relative /docs/ paths

tunetheweb

This is looking much better on desktop but still have the double hamburger menu issues on mobile:

…rchive.org into merge-har-docs Signed-off-by: Max Ostapenko <1611259+max-ostapenko@users.noreply.github.com>

Signed-off-by: Max Ostapenko <1611259+max-ostapenko@users.noreply.github.com>

github-actions · 2026-09-20T20:17:47Z

Visit the preview URL for this PR (updated for commit 1eda9af):

https://httparchive--pr1332-merge-har-docs-znie7fha.web.app

_{(expires Wed, 07 Oct 2026 12:30:19 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: 1069cba7974889c25bacf4f0a19ddb6735592729}

Signed-off-by: Max Ostapenko <1611259+max-ostapenko@users.noreply.github.com>

…and CodeQL TOCTOU race condition

…color alias notation

…ferences

tunetheweb · 2026-09-22T18:07:43Z

Looking better and better. It definitely feels like it's all part of one site now with the same menu persistent across all pages. It's not quite one case, but the illusion is there.

A few more asks for me:

Could we have a consistent footer? Currently the Docs pages don't have any footer at all.
I think, given it's a whole micro-site, this deserves it's own top-level menu item in the header rather than being buried under the About menu.
I still don't understand the need for src/content/docs/docs. Can't it all be under src/content/docs/ and avoid that double doc/docs?

max-ostapenko · 2026-09-23T19:37:18Z

@tunetheweb 'docs/docs/' is Starlights artifact.
It expects a collection under 'src/content/docs/', but as our website is not just docs, keeping the documentation right under 'docs/' will conflict with the rest of Astro pages.

And Starlight doesn't have a feature to define prefix.

…ation Signed-off-by: Max Ostapenko <1611259+max-ostapenko@users.noreply.github.com>

# Conflicts: # package-lock.json # package.json

max-ostapenko · 2026-09-23T21:56:25Z

@tunetheweb with unified footer and header now

tunetheweb

Does the docs Search work for you in the preview? Looks like we might need to add unsafe-eval to our CSP :-(

tunetheweb · 2026-09-25T16:21:23Z

+    align-items: center;
+    justify-content: space-between;
+    box-sizing: border-box;
+    max-width: 1200px;


This looks weird when the docs page isn't constrained. The Logo in the header jumps to the right. Maybe we should drop this?

I adjusted it to the main page, since it's a shared header now.
I understand you expect to see unconstrained on docs/ and centered on the website root?

Let's share the header & footer styling - unconstrained across root and docs?

Yeah sounds good.

The header looks good now.

I still don't see the footer on the docs page?

I removed the footer in docs as the header sticks to the top of the screen.
Having both of them just duplicates the links and squeezes the space for content too much.

Ah OK. In that case I think this looks good to land. I'm just checking with @rviscomi as to how we can redirect har.fyi to this new location.

OK Rick's confirmed he's good to set up a redirect once this is released, so good to merge this.

…olicy Signed-off-by: Max Ostapenko <1611259+max-ostapenko@users.noreply.github.com>

max-ostapenko · 2026-09-28T11:53:33Z

Does the docs Search work for you in the preview? Looks like we might need to add unsafe-eval to our CSP :-(

Fixed CSP.

…yout to full width Signed-off-by: Max Ostapenko <1611259+max-ostapenko@users.noreply.github.com>

max-ostapenko mentioned this pull request Sep 14, 2026

Migrate from App Engine to Firebase Hosting #1333

Merged

tunetheweb requested changes Sep 20, 2026

View reviewed changes

max-ostapenko force-pushed the courageous-galliform branch 2 times, most recently from 62ed224 to 7e256f0 Compare September 20, 2026 14:16

Base automatically changed from courageous-galliform to main September 20, 2026 14:16

max-ostapenko added 2 commits September 20, 2026 21:12

feat: merge har.fyi under docs

652f259

fix(linters): allow unsafe chars and non-unique ids for Starlight docs

3f42796

max-ostapenko force-pushed the merge-har-docs branch from 748b5d9 to 3f42796 Compare September 20, 2026 19:14

github-advanced-security Bot found potential problems Sep 20, 2026

View reviewed changes

Comment thread tools/generate/generate_timestamps.js Fixed

max-ostapenko added 4 commits September 20, 2026 22:10

feat: merge har.fyi under docs

572787d

fix(linters): allow unsafe chars and non-unique ids for Starlight docs

9c9586f

Merge branch 'merge-har-docs' of https://github.com/HTTPArchive/httpa…

9579c54

…rchive.org into merge-har-docs Signed-off-by: Max Ostapenko <1611259+max-ostapenko@users.noreply.github.com>

chore: revert stricter rules in HTMLHint configuration

b016a8a

Signed-off-by: Max Ostapenko <1611259+max-ostapenko@users.noreply.github.com>

max-ostapenko added 7 commits September 20, 2026 22:17

chore: update package-lock.json

39ee01d

refactor: reuse main Header component in docs and add search slot

c2b143a

Signed-off-by: Max Ostapenko <1611259+max-ostapenko@users.noreply.github.com>

Merge branch 'main' into merge-har-docs

aef9cf1

Signed-off-by: Max Ostapenko <1611259+max-ostapenko@users.noreply.github.com>

feat: enforce light theme for documentation and update workbook links

0311adf

Signed-off-by: Max Ostapenko <1611259+max-ostapenko@users.noreply.github.com>

fix(ci): resolve HTMLHint attr-unsafe-chars, stylelint hue notation, …

59f1dc4

…and CodeQL TOCTOU race condition

fix(linters): adjust stylelint rules for custom property spacing and …

05130c1

…color alias notation

refactor: migrate hero image to src/assets and update docs and 404 re…

b3a4348

…ferences

max-ostapenko requested a review from tunetheweb September 21, 2026 16:16

max-ostapenko added 2 commits September 23, 2026 23:46

refactor: extract shared Footer component and add docs links to navig…

e63190a

…ation Signed-off-by: Max Ostapenko <1611259+max-ostapenko@users.noreply.github.com>

Merge remote-tracking branch 'origin/main' into merge-har-docs

0a70e01

# Conflicts: # package-lock.json # package.json

tunetheweb reviewed Sep 25, 2026

View reviewed changes

chore: add wasm-unsafe-eval and worker-src blob to Content-Security-P…

5de2fc9

…olicy Signed-off-by: Max Ostapenko <1611259+max-ostapenko@users.noreply.github.com>

max-ostapenko added 2 commits September 28, 2026 13:53

Merge branch 'main' into merge-har-docs

ab75cc7

refactor: remove docs footer override and update header and footer la…

4bde6c8

…yout to full width Signed-off-by: Max Ostapenko <1611259+max-ostapenko@users.noreply.github.com>

tunetheweb approved these changes Sep 30, 2026

View reviewed changes

max-ostapenko added 2 commits September 30, 2026 14:13

Merge branch 'main' into merge-har-docs

67eba2b

Merge branch 'main' into merge-har-docs

1eda9af

max-ostapenko merged commit 96cdfaf into main Sep 30, 2026
11 checks passed

max-ostapenko deleted the merge-har-docs branch September 30, 2026 12:31

Uh oh!

Conversation

max-ostapenko commented Sep 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

tunetheweb left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented Sep 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

tunetheweb commented Sep 22, 2026

Uh oh!

max-ostapenko commented Sep 23, 2026

Uh oh!

max-ostapenko commented Sep 23, 2026

Uh oh!

tunetheweb left a comment

Choose a reason for hiding this comment

Uh oh!

tunetheweb Sep 25, 2026

Choose a reason for hiding this comment

Uh oh!

max-ostapenko Sep 28, 2026

Choose a reason for hiding this comment

Uh oh!

tunetheweb Sep 30, 2026

Choose a reason for hiding this comment

Uh oh!

max-ostapenko Sep 30, 2026

Choose a reason for hiding this comment

Uh oh!

tunetheweb Sep 30, 2026

Choose a reason for hiding this comment

Uh oh!

tunetheweb Sep 30, 2026

Choose a reason for hiding this comment

Uh oh!

max-ostapenko commented Sep 28, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

max-ostapenko commented Sep 14, 2026 •

edited

Loading

github-actions Bot commented Sep 20, 2026 •

edited

Loading