38 Commits

Author SHA1 Message Date
Caleb Ukle
b97222ded4
docs(nx-dev): fix issue with related docs not loading (#31605)
make sure new paths work for related docs resolution
include related docs for 'legacy' fallback page logic


## before: 
on the `/features/manage-releases` route
![WKMac
2025-06-16T15-37-13](https://github.com/user-attachments/assets/570493bb-571c-47fb-9dd8-dae6b138f951)

on the `/ci/features/affected` route
![WKMac
2025-06-16T15-37-53](https://github.com/user-attachments/assets/f269c6fe-01ec-43a4-a98a-37448d486a54)


## after:
on the `/features/manage-releases` route
![WKMac
2025-06-16T15-38-43](https://github.com/user-attachments/assets/98ed4e98-ea99-485b-b09e-82079bd88fdd)

on the `/ci/features/affected` route
![WKMac
2025-06-16T15-36-17](https://github.com/user-attachments/assets/31bf3be2-3104-4c3c-bdbf-c8701e99ce10)

rename recipes to guides for the related docs card
![WKMac
2025-06-16T16-01-05](https://github.com/user-attachments/assets/4fd6dcf9-dd02-4042-9102-b1d9e72e3866)
2025-06-16 12:03:28 -05:00
Jack Hsu
66eaf2fc74
docs(misc): remove /nx-api pages (#31453)
This PR removes the `/nx-api` pages from `nx-dev`. They are already
redirected from `/nx-api` to either `/technologies` or
`/reference/core-api` URLs.

e.g. `/nx-api/nx` goes to `/reference/core-api/nx` and `/nx-api/react`
goes to `/technologies/react/api`

**Changes**:
- Remove old `nx-api.json` from being generated in
`scripts/documentation/generators/generate-manifests.ts` -- this was
used to generate the sitemap
- Remove `pages/nx-api` from Next.js app since we don't need them
- Remove workaround from link checker
`scripts/documentation/internal-link-checker.ts` -- the angular
rspack/rsbuild and other workarounds are gone now that they are proper
docs in `map.json`
- Update Powerpack/Remote Cache reference docs to exclude API documents
(since they are duplicated in the Intro page) --
`nx-dev/models-document/src/lib/mappings.ts`
- All content in `docs` have been updated with new URL structure

**Note:** Redirects are already handled, and Claude Code was used to
verify the updated `docs/` URLs (see report below). The twelve 404s
links were updated by hand.

## Verification Report

https://gist.github.com/jaysoo/c7863fe7e091cb77929d1976165c357a
2025-06-04 16:57:01 -04:00
Caleb Ukle
4f57f01d01
docs(core): move plugin api docs to tech plugin guides (#31402)
# before

plugin api docs where stuck in `api` section which doesn't make sense

# after

move plugin api docs into `guides` section and add redirect for better
discoverability
2025-06-03 13:43:24 -04:00
Juri Strumpflohner
b51676a89a
docs(core): restructure guides into technologies sections (#31288)
Updates the docs structure, navigation etc to be easier + better suited
for showing Nx technology support beyond just TS.

**Notes:**

- API (`/nx-api`) tab is removed from the navigation (i.e. menu bar),
but pages still remain for now until we update references in `*.md`
files.
- Redirects are set up `/nx-api` to go to their respect new location
e.g. `/technologies` or `/reference/core-api`
- Old URLs still exist in the sitemap for now, but majority of them will
be redirected -- a follow-up PR can remove them.

**Preview:**
https://nx-dev-git-nx-dev-polyglot-docs-restructure-nrwl.vercel.app/docs

---------

Co-authored-by: Jack Hsu <jack.hsu@gmail.com>
2025-05-29 14:55:34 -04:00
Isaac Mann
a1efb63819
fix(nx-dev): breadcrumb casing (#29032)
Fixes the breadcrumb component to show actual page titles instead of
just capitalizing the url segments
2024-11-21 17:20:33 -05:00
Isaac Mann
186a420a74
docs(core): decisions section (#23038)
Create an "Organizational Decisions" section under Concepts for
recommendations and discussions about how to set up Nx that aren't firm
requirements.
2024-05-10 15:42:46 -04:00
Jack Hsu
bc43243498
chore(repo): add eslint and jest plugins to use inferred targets (#22946) 2024-04-23 21:52:13 -04:00
Juri Strumpflohner
3099547de6
feat(nx-dev): improve related docs section (#20796) 2023-12-15 15:49:11 -05:00
Isaac Mann
cf976ce596
feat(nx-dev): allow custom media images (#20561) 2023-12-07 07:37:01 -08:00
Craigory Coppola
30d94f76ee
cleanup(core): remove async flag from signature of buildProjectsConfigurationsFromProjectPathsAndPlugins (#20228) 2023-11-17 15:31:03 -05:00
Isaac Mann
e29e9f90b6
docs(core): fix links (#19339) 2023-09-30 17:00:09 +00:00
Miroslav Jonaš
331707d6eb
docs(nx-dev): make more concepts submenu (#18266) 2023-07-24 14:20:48 +00:00
Jason Jean
ff8074bf75
chore(repo): update to nx 16.0.0-beta.5 (#16347) 2023-04-21 10:17:56 -04:00
Jason Jean
92610fe4b6
chore(repo): update nx to 15.8.0-beta.7 (#15293) 2023-02-27 17:24:06 -05:00
Jason Jean
84fedf36e0
Revert "chore(repo): update nx to 15.8.0-beta.6" (#15274) 2023-02-26 12:39:15 -05:00
Jason Jean
3c50474f40
chore(repo): update nx to 15.8.0-beta.6 (#15247) 2023-02-26 02:26:53 -05:00
Jason Jean
0bf9eb5118
chore(repo): update nx to 15.6.0-beta.0 (#14566) 2023-01-23 23:58:05 +00:00
Craigory Coppola
7992ec618f
chore(repo): setup negative config for several targets (#14080) 2023-01-04 11:34:50 -05:00
Benjamin Cabanes
e5108b84df
docs(nxdev): improve related documentation link matcher (#13982) 2022-12-22 11:06:04 -05:00
Benjamin Cabanes
19fd40ddc7
docs(nxdev): refactor docs sources generation and app consumption (#13834) 2022-12-19 18:59:50 +00:00
Benjamin Cabanes
a064252bcf
docs(nxdev): externalize related documentation links into its own section (#13485) 2022-11-29 17:14:29 -05:00
Craigory Coppola
f311ecbdd7
chore(repo): remove workspace.json (#13040) 2022-11-08 13:12:31 -05:00
Victor Savkin
23de788b5e
chore(repo): update to 15.0.0-rc1 (#12586) 2022-10-13 18:34:24 -04:00
Benjamin Cabanes
e88f6ac768
docs(nxdev): consolidate document metadata interface (#12561) 2022-10-13 10:16:28 -04:00
Isaac Mann
1c0bebf194
docs(nxdev): automatic related docs (#11994)
* feat(nxdev): automatic related docs

* docs(nxdev): use auto related docs
2022-09-15 19:56:15 +00:00
Benjamin Cabanes
40fa765282
docs(nxdev): add auto-generated category/index page with custom content if needed (#12017) 2022-09-15 12:10:04 -04:00
Benjamin Cabanes
353d078dcb
docs(nxdev): add external paths (#11741) 2022-08-26 18:59:47 +00:00
Victor Savkin
f8da1ad42b
chore(repo): update nx to 14.6.0-beta.3 2022-08-12 16:10:56 -04:00
Jack Hsu
520e5852f7
docs(core): read package names from package.json rather than inferrin… (#11520) 2022-08-09 16:42:13 +00:00
Benjamin Cabanes
61e1931ded
docs(nxdev): remove gray-matter dependency (#11150) 2022-07-14 21:57:22 +00:00
Victor Savkin
3d97203b1e
chore(repo): migrate to nx@14.2.0-beta.1 2022-05-30 20:10:02 -04:00
Benjamin Cabanes
abdb5df507
docs(nxdev): harmonize jest config between libs (#10381) 2022-05-18 20:32:54 +00:00
Victor Savkin
6351413b98 fix(core): preserve dash casing when passing args to executors 2022-05-17 14:48:53 -04:00
Benjamin Cabanes
d46e49cd61
docs(nxdev): generate menu api (#10272) 2022-05-12 18:12:04 +00:00
Jason Jean
e4cccfc14d
chore(repo): update nx to 14.1.1 (#10132) 2022-05-04 15:27:43 +00:00
Jason Jean
4f99b77e42
chore(repo): update nx to 14.0.2 (#9974) 2022-04-23 18:06:01 +00:00
Benjamin Cabanes
e66db12e42
docs(nxdev): fill missing project tags (#9565) 2022-03-28 18:12:00 +00:00
Benjamin Cabanes
6dae32cc3a
docs(nxdev): support packages schemas metadata & discoverability (#9383) 2022-03-24 12:00:06 -04:00