Skip to content

adev: Example references by @example are missing #56321

@jnizet

Description

@jnizet

Describe the problem that you experienced

The sections of the documentation such as {@example router/route_functional_guards.ts region="CanMatchFn"} either appear as is in the reference documentation, or don't appear at all.

Enter the URL of the topic with the problem

http://localhost:4200/api/router/CanMatchFn?tab=description

Describe what you were looking for in the documentation

No response

Describe the actions that led you to experience the problem

Trying to encourage people to read the official docuentation in the Angular Discord

Describe what you want to experience that would fix the problem

No response

Add a screenshot if that helps illustrate the problem

No response

If this problem caused an exception or error, please paste it here

No response

If the problem is browser-specific, please specify the device, OS, browser, and version

No response

Provide any additional information here in as much as detail as you can

In other pages, such as https://angular.dev/api/common/NgIf?tab=usage-notes, similar examples are completely omitted from the page. For example, the documentation in the source code has 

 
 * ### Using an external `then` template
 *
 * In the previous example, the then-clause template is specified inline, as the content of the
 * tag that contains the `ngIf` directive. You can also specify a template that is defined
 * externally, by referencing a labeled `<ng-template>` element. When you do this, you can
 * change which template to use at runtime, as shown in the following example.
 *
 * {@example common/ngIf/ts/module.ts region='NgIfThenElse'}

But in the rendered page, there is no following example being displayed.

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2The issue is important to a large percentage of users, with a workaroundarea: docs-infraAngular.dev application and infrastructure

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions