NTEE pages inside the site: browse table, lookup tables guide, resource page rewrite

[Thiyaghessan]

Follows the maintainer's three choices of 2026-09-21 after reviewing the first version: table as a site page, resource page rewritten around three tasks, plain-language lookups page in place of the raw manifest link.

New pages (both inside the site layout, both read the lookup bucket live when opened):

• /datasets/ntee/browse/: the crosswalk table. Major groups as clickable pills, one search box, click a description to open the full definition, download button, vintage stamp from the manifest. Any stray markup in the data is stripped before display.
• /datasets/lookups/: all 17 BMF lookup tables explained in plain words (what the codes mean, which BMF column they decode), row count per table from the manifest, one download link each, and a short section on how to read the manifest. Column names checked against the Unified BMF data dictionary.

Resource page (_resources/ntee.md): rewritten around three tasks. Three primary links instead of six. Sections: what an NTEE code is; for nonprofits (find, choose, change a code); for data users (the code list, NTEE version 2 with the industry/type tables folded away, the accuracy caveat); other taxonomies. The 30-item reading list is kept but collapsed. Contributors unchanged.

Dataset page (_datasets/ntee.md): links now point at the browse page and the lookups page; the raw manifest link is gone.

Old widget URL widgets/ntee_tables/ntee-naics_table.html redirects to the browse page.

Previewed locally by wrapping the pages in the live site shell (Jekyll cannot run on this machine); CI build passes. The one remaining markup glitch in the data (A69) is fixed on the producer side in nccs-data-bmf #57.

ADR 0049

🤖 Generated with Claude Code

[Thiyaghessan]

Is the 2-page cheatsheet outdated? Verify

[Thiyaghessan]

We should still make it clear that we are not responsible for incorrect NTEE codes. We neither assign nor have the capability to change them. Nonprofits with issues must reach out to the IRS. Secondly (and for a separate task and PR. Would it be worth adding functionality for a nonprofit to retrieve its latest NTEE code from this site?)

[Thiyaghessan]

Both review points handled in the latest commit.

Cheat sheet. Verified: the PDF is the May 2005 NTEE-CC list. It has 619 codes; the current IRS list has 645. It lacks 27 codes the IRS assigns today (E6A, K2A-K2C, K6A-K6F, K90-K98, L4A, L4B, M19, N2A, N2B, P76, P7A, P83) and includes Z99, which is not an IRS code. So it is outdated. The guide no longer links it and says why; the file stays in pubs/ so old links do not break. If a printable one-pager is wanted, it should be generated from the lookup so it cannot drift; happy to do that as a follow-up.

Responsibility. The "For nonprofits" section now opens with a call-out: NCCS does not assign, correct, or change NTEE codes; the IRS is the only body that can; contact the IRS if a code is wrong; NCCS is not responsible for codes that are incorrect in IRS records or in data published from them. The "what an NTEE code is" section already said we cannot assign or change codes; this makes it impossible to miss.

Looking up your own code on this site. Worth doing, and cheap: the geocoded Unified BMF is public, so a small page could take an EIN or name and return the organization's current NTEE code, ruling year and the IRS wording, read live the same way the table is. The catch is size (the BMF is 3.6 GB, so the lookup would need a per-EIN endpoint or a DuckDB-on-parquet query, which is where the sector-in-brief API rewrite is heading under ADR 0026). Suggest a backlog row in nccs-contracts so it gets a shape decision rather than a one-off; I will add it when I next touch the backlog unless you want it now.