Repository navigation
docs: remove organization profile README - #36
Merged
Merged
Conversation
Signed-off-by: Lawrence Lane <llane@nvidia.com>
lbliii
requested review from
bernardwin,
ericharper,
euronymous-aithal and
snowmanwwg
as code owners
October 28, 2026 14:39
Contributor
Author
|
@snowmanwwg or @bernardwin could I get your approval? |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Remove
profile/README.mdso theNVIDIA-NeMoGitHub organization landing page uses GitHub's native organization layout (org bio, top-level docs link, pinned flagship repositories, and filterable repository catalog) rather than a manually maintained org-level Markdown file.Why Remove the Organization Profile README?
Maintaining a centralized, multi-column technical matrix in
NVIDIA-NeMo/.githubhas created a structural maintenance trap: it is chronically out of date, suffers from multi-owner consensus deadlock, and diverges from standard practice across both NVIDIA and peer AI organizations.Below is the empirical data from a live audit of 25 peer GitHub organizations and the commit/PR history of
NVIDIA-NeMo/.github.1. Industry & NVIDIA Precedent: 80% of Peer Orgs Do Not Use a Profile README
We audited 25 peer AI labs, ML infrastructure ecosystems, NVIDIA organizations, and developer platforms via the GitHub API (
GET /repos/:org/.github/contents/profile/README.md).profile/README.mdat all.huggingface,openai,anthropics,google-deepmind,meta-llama,deepseek-ai,mistralai) use an org profile README.pytorch,vllm-project,ray-project,sgl-project,jax-ml) omitprofile/README.mdand rely on pinned repositories and canonical documentation sites.NVIDIA,rapidsai,nv-morpheus) have.githubrepositories for shared CI/templates, and none of them publish aprofile/README.md.lightning-aiis 2 sentences (199 B) andmicrosoftis a static pointer to their open-source portal and Code of Conduct (1,135 B). At 8,535 B,NVIDIA-NeMohas the largest and most complex org profile README in the entire cohort (2.7x larger than the next largest).Full 25-Organization Comparative Benchmark Table (Oct 2026)
profile/README.md?huggingfaceopenaianthropicsgoogle-deepmind.githubrepo; pinned reposmeta-llamadeepseek-aimistralaipytorchvllm-projectvllmrepo anddocs.vllm.ailinkray-project.githubrepo holds only workflows and templatessgl-projectjax-ml.githubrepo; pinned repositoriesNVIDIArapidsai.githubrepo used strictly for CI/shared confignv-morpheus.githubrepo used for shared org configastral-shuv,ruff,tyrepositoriesvercelnext.js,ai,turboreposupabasecloudflaregoogle.githubrepo holds only org configlightning-aimicrosoftopensource.microsoft.com& CoCopen-mmlablangchain-aitriton-inference-serverdocs.nvidia.comNVIDIA-NeMo2. Chronic Staleness & Drift in
NVIDIA-NeMoBecause
NVIDIA-NeMois a fast-moving modular organization with dozens of independent repositories, a manually curated feature matrix in.githubfalls out of date almost immediately:NVIDIA-NeMocurrently has 30 active, non-archived public repositories (excluding.github), but the table inprofile/README.mdonly lists 17. Thirteen active public repositories are completely absent from the table:Lens,UserSim,DataDesignerPlugins,ProRL-Agent-Server,SDG-PGMs,agent-hardener,eval-author,nemo-compass,nemo-helix,FW-CI-templates,labs-OO-Agents,labs-Voice-Agent, andlabs-molt.NVIDIA-NeMo/RL(blob/fa379fffbc9c5580301fa748dbba269c7d90f883/examples/configs/dpo.yaml#L99andgrpo_math_1B_megatron.yaml#L79) rather than stable documentation.### Diagram Ilustration of Repos under NeMo Framework (WIP)(with both the spelling error "Ilustration" and the(WIP)label sitting live on our primary GitHub landing page since August 2025).2024-2025.3. Multi-Owner Consensus Deadlock & Maintenance Tax
NVIDIA-NeMo/.github, 34 PRs (94%) were solely to edit the README, add a row, or fix broken Markdown table syntax and typos (e.g., back-to-back table/typo fixes in #20, #21, #22, #26, #27). Only 2 PRs in the history of the repo (#1 forCODEOWNERSand #11 forISSUE_TEMPLATE) were for actual org-wide GitHub configuration..github/CODEOWNERSassignsprofile/to 4 reviewers, while the content attempts to represent 30 independent repositories and sub-teams.4. What Replaces It? (Why GitHub's Native UI Works Better)
Removing
profile/README.mddoes not leave the organization page blank—it promotes GitHub's native discovery surfaces above the fold:github.com/NVIDIA-NeMomust scroll past an 8.5 KB wall of tables and a large PNG diagram before seeing a single repository card. Removing the profile README brings Pinned Repositories (Automodel,RL,Megatron-Bridge,Curator,Guardrails,Evaluator, etc.) directly to the top of the page, with live star counts, descriptions, and languages automatically synced from each repo.NVIDIA-NeMo/.github.docs.nvidia.com/nemo), which is linked directly from the GitHub organization header.