Skip to content

Add project page (GitHub Pages, /docs) - #2

Open
rustnew wants to merge 4 commits into
mainfrom
feature/github-pages
Open

Add project page (GitHub Pages, /docs)#2
rustnew wants to merge 4 commits into
mainfrom
feature/github-pages

Conversation

@rustnew

@rustnew rustnew commented Sep 2, 2026

Copy link
Copy Markdown
Owner

What changed and why

Adds docs/index.html, a self-contained static landing page for GitHub
Pages, so the project has a link that isn't "go read a README on GitHub" --
useful for sharing outside GitHub (e.g. the Reddit posts prepared for
r/LocalLLaMA, r/LLMDevs, r/learnmachinelearning, r/ArtificialIntelligence).
Also adds the page's link to the README once Pages is enabled.

Evidence

Not a results/code change -- pure presentation, no new claim. Every
number and finding on the page is copied verbatim from the README /
results/reports/*.md, not recomputed or restated differently:

  • 47% / baseline 38%, regret table -> results/reports/...compare_meta_predictors.md

  • rho 0.670 -> 0.395 correction -> results/reports/...gate1_ranking_at_scale.md

  • Xavier/He 0.0 difference -> results/reports/...explore_scale_invariance_blindspot.md

  • N/A (presentation-only PR) -- see note above instead of a script run.

  • No claim on the page differs from the README/reports it's copied from.

  • N/A -- no negative result introduced here.

Checklist

  • CI (reproduce.yml) passes on this branch.
  • No claim in this PR is asserted without a script/report backing it.
  • data/meta_dataset.db not touched.
  • README updated (added the Pages link).

Open questions / requested feedback

GitHub Pages itself is not yet enabled on the repo (Settings → Pages →
source: branch main, folder /docs) -- that's a repo-setting change
outside this diff's scope, needs to happen once this merges for the
rustnew.github.io/precog-trainability/ link in the README to resolve
instead of 404ing. Flagging so it isn't forgotten post-merge.

…indings

Self-contained static HTML (docs/index.html, no build step, .nojekyll to
serve it as-is) -- a single landing page presenting the same three
findings as the README (jacob_cov as best-evidenced method, the
rho=0.670->0.395 correction, the Xavier/He scale-invariance bug) for
readers arriving from a link rather than the repo directly. Every number
and link on the page matches the README/reports exactly, no new claims.

README: added the project-page link once GitHub Pages is enabled
(Settings -> Pages -> branch main, /docs -- not yet turned on, see PR
description).
@coderabbitai

coderabbitai Bot commented Sep 2, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Team

Run ID: 08c6811b-b2a7-4ad2-9090-2cde0b1d8c41


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@rustnew
rustnew requested a review from Blindspot22 September 2, 2026 20:21
…ction

- White background, sans-serif, restrained accent color -- cleaner and
  more in line with the project's own emphasis on evidence over
  presentation than the previous cream/serif academic-paper look.
- New section linking karpathy/autoresearch: not a claim of affiliation
  or equivalence (different problem -- autonomous training-code agent vs
  pre-training hyperparameter prediction), but an honest nod to the same
  underlying bet, tight/cheap experimental loops run fast and logged
  honestly, wins and failures alike.
Requested framing: show readers the concrete practical benefit, not just
proxy-correlation numbers. Added to both the project page and README,
using two real, verified cases from the locked test set (not
hypothetical): one task where 2 of 3 init choices never converge within
budget and our pick is the one that does (627 vs 1600 steps), another
where our pick needs 61 steps against 208 for the worst choice (3.4x).
Both explicitly framed as real wins, not the average case (47% overall).

Also explicitly corrects a 'less data' framing: that's a different claim
this project tested directly (active sample selection, source.md pillar
6) and found negative (0/12 tasks, -267.6% worse). Restored
precog/active_learning.py, scripts/explore_active_learning.py and its
report from the full project (previously excluded as 'abandoned
exploratory code') since the page now cites it as evidence for what this
project does NOT demonstrate -- added to CI so that claim stays honest
too.
Requested: make sure every research method/hypothesis used has a link,
not just a name-drop. Verified every arXiv ID via search before linking
(never guessed one) -- NASWOT 2006.04647, NEAR 2408.08776, ZiCo 2301.11300,
AZ-NAS 2403.19232, SynFlow 2006.05467, SNIP 1810.02340, GraSP 2002.07376,
LSUV 1511.06422.

- New 'References' section on the project page: every method used, linked
  to the original paper, with what it was used for.
- README: inline links for every method mentioned (was name-only before).
- source.md: fixed 2 real gaps found doing this -- ZiCo and AZ-NAS were
  used directly in scripts/gate1_ranking.py but never appeared in the
  bibliography at all; NASWOT and NEAR were named without any link;
  SynFlow/SNIP/GraSP/LSUV were only cited via the survey paper that
  benchmarks them, not their own original papers.
- Restored scripts/explore_lsuv_init.py and its report (previously
  excluded as 'abandoned exploratory code') since source.md and the page's
  References table now cite it as evidence -- every claim needs a script
  behind it, added to CI so it stays that way.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant