Commit Graph

6956 Commits

Author SHA1 Message Date
dario-piotrowicz 0ae4187566 refactor(docs-infra): remove eslint directive comments from examples (#43831)
Linting has recently been removed from the examples provided in angular.io
(see PRs #43592 and #43746) such removal effects the downloadable and
stackblitz examples but linting is still generally used in the examples
in the aio project itself (they are being migrated from tslint to eslint in
PR #43218) thus eslint directive comments are still necessary in the code itself.

So the comments need to be present but need not to be exposed to the users
(not in the zips, stackblitzes nor docs themselves), these changes are
removing such comments during the examples' parsing phase (effectively
removing them from all three sources mentioned above).

Original discussion: https://github.com/angular/angular/pull/43218#discussion_r697305494

resolves #43788

PR Close #43831
2021-11-09 18:02:33 +00:00
profanis 50ed778921 docs(animations): express the seconds in numbers (#40098)
I've noticed that the seconds are expressed both by using numbers and words.
For example, the doc says `0.5 second` and not `half second`.
I believe is more readable to express them by using numbers and is consistent too.

PR Close #40098
2021-11-09 18:01:46 +00:00
Pete Bacon Darwin b39fd5fe50 docs: update getting started tutorial to use StackBlitz web-containers (#44085)
Previous commits changed the docs to use web-container versions for StackBlitz examples.
This commit updates the content of the tutorial to match.

Fixes #44079

PR Close #44085
2021-11-08 18:12:16 +00:00
Pete Bacon Darwin dc7e5a1e01 build(docs-infra): remove link to custom Stackblitz for running tests (#44085)
Previously there was a custom version of the testing app for Stackblitz that would run the tests in the browser.
With the web-container approach, this is no longer necessary since the tests can be run directly from the command line.

Fixes #44047

PR Close #44085
2021-11-08 18:12:16 +00:00
Pete Bacon Darwin 9759799f63 build(docs-infra): ensure necessary boilerplate files appear in Stackblitz examples (#44085)
The `tsconfig.app.json` and similar were not appearing in the generated Stackblitz examples.

PR Close #44085
2021-11-08 18:12:16 +00:00
Pete Bacon Darwin b4ecc158de build(docs-infra): remove unused code (#44085)
This import was not being used and so it is redundant and can be removed.

PR Close #44085
2021-11-08 18:12:16 +00:00
Pete Bacon Darwin 49964c89e6 docs: add Angular 13 support information (#44098)
Closes #44097

PR Close #44098
2021-11-08 17:03:58 +00:00
Michael Urban baab456e56 docs(animations): update developers on state of package (#44014)
Notify developers that @angular/animations package has been "significantly de-prioritized"

`animateChild` documentation now references #30477

References #30477# Please enter the commit message for your changes. Lines starting

PR Close #44014
2021-11-08 17:03:28 +00:00
George Kalpakas 37e02750a7 build(docs-infra): fix SystemJS-based docs examples (#43868)
Previously, the SystemJS-based docs examples (typically `ngUpgrade`
examples) were not compatible with Angular v13 (due to the removal of
UMD bundles from the published packages).

This commit makes the examples compatible with Angular v13 and
re-enables the tests for all SystemJS-based examples on CI.

PR Close #43868
2021-11-08 17:01:16 +00:00
George Kalpakas 62e5285cca build(docs-infra): include systemjs as a dependency to SystemJS-based docs examples (#43868)
Due to an oversight, the `systemjs` package was previously not included
as a dependency in the boilerplate `package.json` file for
SystemJS-based docs examples, despite it being required by the app.

PR Close #43868
2021-11-08 17:01:16 +00:00
George Kalpakas 9e55a7d5f2 docs(upgrade): minor fixes to the upgrade guide (#43868)
Includes the following fixes:
- Remove unused `format` attribute from `<code-example>` elements
- Explicitly mention that the starting point for the "Phonecat Upgrade
  Tutorial" is the 1.5.x version of the original Phonecat tutorial
  (since the original tutorial has since been updated to use AngularJS
  v1.8.x and use npm instead of bower).

PR Close #43868
2021-11-08 17:01:16 +00:00
Joe Martin (Crowdstaffing) 36e75d3ddb docs: update link (#44017)
Update link to match heading.

PR Close #44017
2021-11-08 17:00:18 +00:00
Renovate Bot 725a1a49ec build: lock file maintenance (#44003)
PR Close #44003
2021-11-05 20:05:41 +00:00
Joey Perrott 3f07e20bda docs: remove reference of testing against BrowserStack (#43858)
Remove BrowserStack from statement about CI tests using the service as Angular now only uses Saucelabs for
our platform specific browser testing.

PR Close #43858
2021-11-05 19:56:03 +00:00
Joey Perrott 4206d493e9 docs: update listed supported browsers to accurately reflect support browsers (#43858)
Update documentation to note 2 most recent major versions of Android browser support
rather than explictly listing browsers.

PR Close #43858
2021-11-05 19:56:03 +00:00
Dustin M. Eastway 544c26d779 docs: fix typescript errors for the schematics-for-libraries example (#30966)
PR Close #30966
2021-11-05 16:33:26 +00:00
Dustin M. Eastway 024fd9d9f0 docs: add cross-platform support to postbuild in schematics-for-libraries (#30966)
Use the cross-platform `copyfiles` package instead of using `cp` which fails on Windows machines when copying files in the `postbuild` script of the "schematics-for-libraries" example.

PR Close #30966
2021-11-05 16:33:26 +00:00
Aristeidis Bampakos 22edf0263f docs: update install guide for angular elements (#44077)
Co-Authored-By: George Kalpakas <kalpakas.g@gmail.com>

PR Close #44077
2021-11-05 16:21:57 +00:00
Alan Agius 523e8fd8a3 docs: update Definition of Terms in APF guide (#44060)
Several improvements to the Definition of Terms of terms section in the APF guide.

PR Close #44060
2021-11-04 18:59:13 +00:00
Alan Agius df2e862cae docs: unlink async keyword in APF guide (#44060)
Currently, `async` keywords in the APF guide incorrectly links to https://angular.io/api/common/AsyncPipe

PR Close #44060
2021-11-04 18:59:13 +00:00
Alan Agius f12f6de3c6 docs: update apf guide files layouts table (#44060)
With this change we improve the file layout structure table and align it with other similar tables example: https://angular.io/guide/file-structure

PR Close #44060
2021-11-04 18:59:13 +00:00
mgechev 7441747087 docs: update roadmap update date (#44036)
PR Close #44036
2021-11-04 18:56:14 +00:00
Alan Agius 36388b3ab2 build(docs-infra): configure region parser to allow .mjs (#44027)
This commit updates the necessary config settings to allow `.mjs` files to be able to be parsed by the region parser. We configure the parser to use `inline-c-only` so that comments are generated in like the below

```
// #docregion
```

rather than

```
/* #docregion */
```

PR Close #44027
2021-11-04 18:55:52 +00:00
Alan Agius 2f62a9a548 docs: improve consuming partial-Ivy code outside the Angular CLI (#44027)
With this change we add an example of how to consume the linker plugin and also clean up the parts of this section.

Closes #44026

PR Close #44027
2021-11-04 18:55:52 +00:00
mgechev 02b84af5bd docs: update the survey expiry date (#44021)
PR Close #44021
2021-11-04 18:55:24 +00:00
Joel Lefkowitz ab423f5ee9 docs: amend inaccurate immutability definition (#43951) (#43951)
PR Close #43951

PR Close #43951
2021-11-04 18:53:18 +00:00
Pete Bacon Darwin 8020457ce2 build(docs-infra): target webcontainers for stackblitz "live-example" links (#44041)
This commit changes the Stackblitz live examples to create "webcontainer" projects on Stackblitz.
This approach supports the new Angular v13 packaging formats but webcontainers are not supported on some browers. So this is a temporary solution.

PR Close #44041
2021-11-03 16:19:56 -07:00
Renovate Bot 595a7e3dcd build: update angular (#44024)
PR Close #44024
2021-11-03 15:06:36 -07:00
George Kalpakas 3574e7d9e9 build(docs-infra): update Angular CLI/framework/Material to final v13 RCs in docs examples (#43583)
This commit updates the docs examples to the latest prerelease versions
of Angular CLI, framework and CDK/Material.

It also updates the apps to more closely align with new apps CLI apps.
See also the [diff][1] between a basic v13.0.0-rc.0 CLI app and a
v13.0.0-rc.2 one.

[1]: cexbrayat/angular-cli-diff@13.0.0-rc.0...13.0.0-rc.2

PR Close #43583
2021-11-02 17:31:58 -07:00
Paul Gschwendtner ac8b5bffe4 build(docs-infra): update AIO to angular framework/components/cli final RCs (#43583)
Updates AIO to the latest v13 release-candidate version of all
Angular-owned packages, such as Angular CDK and Angular Material.

Applies changes needed for the v13 CLI as performed by the CLI
through `ng update`:

https://github.com/angular/angular-cli/tree/7ff8c5350ea2e49574dd659adae02215957d2685/packages/schematics/angular/migrations/update-13.

Additionally, the web components polyfill has been removed as all browsers
supported by Angular seem to support custom elements v1 natively, according to:

* https://caniuse.com/custom-elementsv1
* https://www.webcomponents.org/ (scroll down to browser support)

Co-authored-by: George Kalpakas <kalpakas.g@gmail.com>

PR Close #43583
2021-11-02 17:31:58 -07:00
Alex Rickabaugh 509b14536a docs: initial commit of Angular Package Format documentation (#43987)
This commit adds the Angular Package Format to AIO. Previously this document
was updated and versioned in Google Docs.

The document is also updated for the Angular Package Format version 13.

PR Close #43987
2021-11-01 18:24:21 -07:00
Joe Martin (Crowdstaffing) 1f8d5c3aec docs: update per feedback (#44009)
Update content per feedback from previous PR.

PR Close #44009
2021-11-01 17:38:53 -07:00
mgechev 32fa5335c6 docs: update the roadmap in alignment with v13 progress (#43986)
PR Close #43986
2021-11-01 14:02:14 -07:00
Joe Martin (Crowdstaffing) 3d1ac6a009 docs: update left-nav (#43964)
Update left-nav toc.

PR Close #43964
2021-10-29 16:51:32 -07:00
Joe Martin (Crowdstaffing) 73b35afbee docs: add link (#43964)
Add link for RFC. Clean up markdown formatting.

PR Close #43964
2021-10-29 16:51:32 -07:00
Joe Martin (Crowdstaffing) fe4bceb04e docs: update per tech review (#43964)
Update content per feedback in tech review.

PR Close #43964
2021-10-29 16:51:32 -07:00
Joe Martin (Crowdstaffing) 19b2d6d2ea docs: update release notes (#43964)
Update release note for version 13.

PR Close #43964
2021-10-29 16:51:32 -07:00
Joe Martin (Crowdstaffing) 9316254062 docs: add redirect test (#43964)
Add redirect test for new latest version topic.

PR Close #43964
2021-10-29 16:51:32 -07:00
Joe Martin (Crowdstaffing) 13f6243a03 docs: add links (#43964)
docs: add links to additional information.

PR Close #43964
2021-10-29 16:51:32 -07:00
Joe Martin (Crowdstaffing) 98912bf811 docs: remove previous latest verison (#43964)
Remove content for previous latest version.

PR Close #43964
2021-10-29 16:51:32 -07:00
Joe Martin (Crowdstaffing) 557cabc980 docs: update migration content (#43964)
Update content for AngularJS to Angular migration.  Add note to manually create UMD bundles.

PR Close #43964
2021-10-29 16:51:32 -07:00
Joe Martin (Crowdstaffing) 8cded1743a docs: update library use content (#43964)
Update content for library use.

PR Close #43964
2021-10-29 16:51:32 -07:00
Joe Martin (Crowdstaffing) fc3cd38125 docs: add latest version content (#43964)
Add the update to latest version content for version 13.  Add redirect for latest version content.  Update toc for later version content.

PR Close #43964
2021-10-29 16:51:32 -07:00
Alan Agius 408e4dafbd fix(docs-infra): search box input line-height (#43983)
This fixes an issue on Safari which caused the text to be pushed down when blurring out of the search input field. The root cause of the problem appears to be that previously the computed line height was that of 32px, which caused a shift in content.

Closes #43935

PR Close #43983
2021-10-29 15:47:06 -07:00
Joe Martin (Crowdstaffing) 6e32fa2f03 docs: update note (#43979)
Update the note for hierarchy of locale identifiers.

PR Close #43979
2021-10-29 15:46:33 -07:00
Joe Martin (Crowdstaffing) 4b4996fd34 docs: remove link (#43979)
Remove redundant link.

PR Close #43979
2021-10-29 15:46:32 -07:00
George Kalpakas a01e02d4e2 refactor(docs-infra): remove obsolete way of disabling DocViewer animations (#43977)
Previously, there were two ways to disable view transition animations in
`DocViewerComponent`: Using a `.no-animations` CSS class on the
`<aio-doc-viewer>` element and setting the static
`DocViewerComponent.animationsEnabled` property to `false`. The latter
was only used to disable animations for testing purposes.

With the recent introduction of `AppComponent.reducedMotion`, there is
now an easy way to disable animations in tests using the
`.no-animations` class (which is applied by `AppComponent` based on the
value of `AppComponent.reducedMotion`). Therefore, it is no longer
necessary to have `DocViewerComponent.animationEnabled`.

This commit removes the now obsolete `animationsEnalbed` property.

PR Close #43977
2021-10-29 15:44:58 -07:00
George Kalpakas df5f737081 fix(docs-infra): improve accessibility by respecting prefers-reduced-motion (#43977)
Make the app easier to use for people with motion sensitivities by
disabling several animations (esp. ones involving moving things around)
when the user prefers reduced motion. The user's preference is detected
using the [prefers-reduced-motion][1] CSS media feature.

Disabled animations include:
- View fade in/out transitions.
- Sidenav open/close animations.
- Top-menu color and size changes.
- Contributor cards flip animations.

For more details on using `prefers-reduced-motion` and disabling
Angular animations see:
- [Designing with reduced motion for motion sensitivities][2]
- [Disabling Angular animations at runtime][3]

[1]: https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-reduced-motion
[2]: https://www.smashingmagazine.com/2020/09/design-reduced-motion-sensitivities/
[3]: https://dev.to/this-is-angular/disabling-angular-animations-at-runtime-9a6

PR Close #43977
2021-10-29 15:44:58 -07:00
Alan Agius 9867a5d704 docs: update elements page (#43975)
This section was outdated since now all CLI projects are es2015+ and don't require the polyfill since legacy browsers are no longer supported.

PR Close #43975
2021-10-29 15:43:55 -07:00
Andrew Kushnir 967283e8a1 docs: update dynamic component guide to use factory-less ViewContainerRef.createComponent (#43895)
PR Close #43895
2021-10-29 15:39:04 -07:00