748faa4f95
docs(docs-infra): Add build-time validation for API and guide links using route manifest
...
Adds build-time validation to catch broken, stale, or miscased internal documentation links in both JSDoc and markdown, including `/api/` and `/guide/` URLs and their fragments. Updates the documentation pipeline to share the canonical route manifest, ensuring that all references are checked against the current navigation structure.
(cherry picked from commit c1829f6d7c
2026-07-08 10:24:51 -07:00
2e4673b63c
fix(docs-infra): add target="_blank" to external links in @see JSDoc tags
...
External links rendered via `@see {@link ...}` and `@see [label](url)`
were not opening in a new tab. The `getHtmlAdditionalLinks` function
now sets `target: '_blank'` on `LinkEntryRenderable` objects whose URL
is external, and `docs-pill-row.tsx` passes the `target` attribute to
the rendered anchor tag.
Fixes : #69593
(cherry picked from commit 892a6eb69a
2026-07-06 13:39:52 -07:00
d2c7b4e111
docs(docs-infra): Validate case-sensitive API symbol links in @link
...
Adds build-time validation for case-sensitive API symbols in `@link`. Avoid broken links
2026-04-27 17:01:40 -07:00
f0b1061791
docs(docs-infra): Handle additional description format
...
Ex: https://angular.dev/api/router/withExperimentalPlatformNavigation
2026-01-21 11:37:08 -08:00
8199945637
refactor(core): add dedicated deprecated signatures for providedIn: any / NgModule.
...
Those were deprecated by #47616 back in v15.
fixes #65923
2025-12-09 10:38:09 -08:00
ef034c15c1
docs(docs-infra): renders inline code snippets in docs pills
...
Improves the rendering of `DocsPillRow` to correctly display inline code snippets (using backticks) within the pill labels.
2025-11-25 18:30:05 -05:00
f3d056a065
docs(docs-infra): Prevent empty extends clause in interface documentation
...
Interfaces with no extends clause were incorrectly rendered with a trailing extends keyword followed by nothing, resulting in invalid TypeScript syntax
2025-10-29 18:48:30 +01:00
31c689a5f4
docs(docs-infra): highlight & parse api descriptions. ( #63536 )
...
The prevent future regression of this, this commit introduces additional tests.
PR Close #63536
2025-09-02 16:49:10 +00:00
47dc4ffd1a
docs(docs-infra): share markdown rendering and highlighting code between api-gen and guides ( #63357 )
...
This reduces code duplication and improves the maintability.
PR Close #63357
2025-08-25 15:33:55 -07:00
5f1c08d75f
build: migrate adev shared-docs package to use ts_project ( #61193 )
...
Migrate the build rules for shared docs to use ts_project
PR Close #61193
2025-05-09 16:30:05 +00:00
286e4da52b
docs(docs-infra): Throw error at build time for invalid links ( #59162 )
...
PR Close #59162
2025-03-04 20:07:23 +00:00
2e03a8685b
docs(docs-infra): Improve support for @link within the jsdoc. ( #60201 )
...
PR Close #60201
2025-03-04 17:13:42 +00:00
f15ccb94b9
docs(docs-infra): enable tslint ( #58961 )
...
PR Close #58961
2024-12-05 16:03:35 -08:00
c95aca1f17
docs(docs-infra): update default generic values and add constraints for type parameters in functions ( #58548 )
...
Before
```typescript
createNodeRequestHandler(
handler: T
): T;
```
```typescript
class NgIf<T> {
@Input() set ngIf(value: T);
@Input() set ngIfThen(value: TemplateRef<NgIfContext<T>> | null);
@Input() set ngIfElse(value: TemplateRef<NgIfContext<T>> | null);
static ngTemplateGuard_ngIf: "binding";
static ngTemplateContextGuard<T>(dir: NgIf<T>, ctx: any): boolean;
}
```
Now
```typescript
createNodeRequestHandler<T extends NodeRequestHandlerFunction>(
handler: T
): T;
```
```typescript
class NgIf<T = unknown> {
@Input() set ngIf(value: T);
@Input() set ngIfThen(value: TemplateRef<NgIfContext<T>> | null);
@Input() set ngIfElse(value: TemplateRef<NgIfContext<T>> | null);
static ngTemplateGuard_ngIf: "binding";
static ngTemplateContextGuard<T>(dir: NgIf<T>, ctx: any): boolean;
}
```
PR Close #58548
2024-11-08 17:15:06 +00:00
dbdd7875dd
docs: Enable direct links to class/interface methods for @link ( #57615 )
...
PR Close #57615
2024-09-06 16:03:36 +00:00
1b7571f404
docs(docs-infra): enable tests for api-gen ( #57618 )
...
PR Close #57618
2024-09-05 14:05:04 +00:00
3bdead1b2f
refactor(docs-infra): migrate api-gen from dev-infra into the repo ( #57241 )
...
Move the api-gen pipeline into the shared-docs directory.
PR Close #57241
2024-08-05 17:06:29 +00:00
SkyZeroZx