Skip to content

Commit

Permalink
docs(core): embed videos for powerpack features
Browse files Browse the repository at this point in the history
  • Loading branch information
juristr committed Sep 26, 2024
1 parent fc39bea commit 8f3269d
Show file tree
Hide file tree
Showing 5 changed files with 10 additions and 4 deletions.
4 changes: 2 additions & 2 deletions docs/generated/manifests/nx.json
Original file line number Diff line number Diff line change
Expand Up @@ -441,7 +441,7 @@
{
"id": "powerpack",
"name": "Powerpack Features",
"description": "Features of Nx that are available with a powerpack license.",
"description": "Nx Powerpack is a suite of paid extensions for the Nx CLI specifically designed for enterprises.",
"mediaImage": "",
"file": "",
"itemList": [
Expand Down Expand Up @@ -646,7 +646,7 @@
"/features/powerpack": {
"id": "powerpack",
"name": "Powerpack Features",
"description": "Features of Nx that are available with a powerpack license.",
"description": "Nx Powerpack is a suite of paid extensions for the Nx CLI specifically designed for enterprises.",
"mediaImage": "",
"file": "",
"itemList": [
Expand Down
2 changes: 1 addition & 1 deletion docs/map.json
Original file line number Diff line number Diff line change
Expand Up @@ -134,7 +134,7 @@
{
"name": "Powerpack Features",
"id": "powerpack",
"description": "Features of Nx that are available with a powerpack license.",
"description": "Nx Powerpack is a suite of paid extensions for the Nx CLI specifically designed for enterprises.",
"itemList": [
{
"name": "Run Language-Agnostic Conformance Rules",
Expand Down
2 changes: 2 additions & 0 deletions docs/shared/features/powerpack/conformance.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Run Language-Agnostic Conformance Rules

{% youtube src="https://youtu.be/6wg23sLveTQ" title="Nx Powerpack workspace conformance" /%}

The [`@nx/powerpack-conformance`](/nx-api/powerpack-conformance) plugin allows [Nx Powerpack]() users to write and apply rules for your entire workspace that help with **consistency**, **maintainability**, **reliability** and **security**.

The conformance plugin allows you to **encode your own organization's standards** so that they can be enforced automatically. Conformance rules can also **complement linting tools** by enforcing that those tools are configured in the recommended way. The rules are written in TypeScript but can be **applied to any language in the codebase** or focus entirely on configuration files.
Expand Down
4 changes: 3 additions & 1 deletion docs/shared/features/powerpack/custom-caching.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,12 @@
# Self-Host the Remote Cache

{% youtube src="https://youtu.be/vRGAa5SuiTM" title="Nx Powerpack self-hosted cache storage" /%}

The recommended way to enable the [remote cache](/ci/features/remote-cache) is to use Nx Replay and have Nx Cloud share the task cache across your organization. For those organizations that are unable to use Nx Cloud, Nx offers official plugins that are enabled by [Nx Powerpack]() to self-host the remote cache in a fast and secure manner. The recommended ways to host the remote cache are, in order of preference:

1. [Nx Replay](/ci/features/remote-cache): Cache is hosted on Nx Cloud servers or on-premise with an [Nx Enterprise](/enterprise) contract
2. [@nx/powerpack-s3-cache](/nx-api/powerpack-s3-cache): Cache is on a self-hosted, fully secure AWS S3 bucket
3. [@nx/powerpack-shared-fs-cache](/nx-api/powerpack-s3-cache): Cache is self-hosted and self-secured on a shared file system location
3. [@nx/powerpack-shared-fs-cache](/nx-api/powerpack-shared-fs-cache): Cache is self-hosted and self-secured on a shared file system location

The options range from fully opting in to Nx's management of the remote cache to fully managing the configuration and security of your own remote cache.

Expand Down
2 changes: 2 additions & 0 deletions docs/shared/features/powerpack/owners.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Define Code Ownership at the Project Level

{% youtube src="https://youtu.be/mor6urvw-L0" title="Nx Powerpack Codeowners" /%}

This plugin provides the ability to configure and maintain code owners for projects in an Nx workspace.

The atomic unit of code in an Nx workspace is a project. Tasks, module boundaries and the Nx graph all train us to conceptualize the workspace as a collection of projects. The CODEOWNERS file, however, requires you to switch from a project mental model to a more low-level definition based on the folder structure of your workspace. The `@nx/powerpack-owners` plugin enables you to stay in the mental model that your workspace is a collection of projects as you define the ownership rules for your workspace. Nx will take care of compiling the project ownership rules into file-based ownership rules that [GitHub](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners), [Bitbucket](https://support.atlassian.com/bitbucket-cloud/docs/set-up-and-use-code-owners/) or [GitLab](https://docs.gitlab.com/ee/user/project/codeowners/) can understand in the CODEOWNERS file.
Expand Down

0 comments on commit 8f3269d

Please sign in to comment.