Skip to content

Conversation

barbara-celi
Copy link
Contributor

@barbara-celi barbara-celi commented Jun 27, 2025

Types of changes

  • New content (guides, endpoints, app documentation)
  • Improvement (make a documentation even better)
  • Fix (fix a documentation error)
  • Spelling and grammar accuracy (self-explanatory)

EDU-15496

@barbara-celi barbara-celi requested a review from a team June 27, 2025 13:30
@barbara-celi barbara-celi self-assigned this Jun 27, 2025
Copy link
Contributor

Navigation Preview Link

No changes detected in the navigation.json file

Copy link
Contributor

github-actions bot commented Jun 27, 2025

Preview Links

Open this URL to set up the portal with this branch changes.

You can now access the edited pages with the following URLs:

…alyzer

LOC-20587 - EDU-15496 - Implementing FastStore Analyzer #2032
@barbara-celi barbara-celi removed the request for review from a team July 31, 2025 19:56
Copy link
Contributor

Grammar review summary

Review for docs/faststore/docs/faststore-analyzer/implementation.md

The document is well-written and clear. The identified issues are minor stylistic improvements related to sentence flow and the formal use of examples in technical documentation. No spelling errors were found.


Was this feedback useful?

  • Yes
  • No

| `cssOptions` | `object` | Options for validating and transforming CSS namespace usage. |
|   ├─`allowedNamespaces` | `string` | Array of allowed CSS namespace prefixes (example: `['extension-']`). Only selectors with these prefixes will be considered compliant. |
|   ├─`transformNonCompliant` | `boolean` | If `true`, automatically updates non-compliant CSS selectors to match the expected namespace format. |
|   ├─`defaultNamespace` | `string` | Default namespace prefix applied to selectors when auto-fixing non-compliant CSS (example: ` 'extension-'`. |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[markdownlint] reported by reviewdog 🐶
MD038/no-space-in-code Spaces inside code span elements [Context: " 'extension-'"]


In this guide, you'll learn how to securely implement [Extension points](LINK) in [FastStore modules](LINK) by using FastStore Analyzer.

FastStore Analyzer is a static analysis tool that helps maintain code quality and security in FastStore projects. By integrating it into your development workflow with customizable CLI hooks, it scans your codebase to identify issues before they affect your build.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [Grammar reviewer] reported by reviewdog 🐶
Rephrasing improves sentence flow and clarity by making 'FastStore Analyzer' the clear subject of the scanning action, avoiding the slightly awkward 'By integrating it... it scans' construction.

Suggested change
FastStore Analyzer is a static analysis tool that helps maintain code quality and security in FastStore projects. By integrating it into your development workflow with customizable CLI hooks, it scans your codebase to identify issues before they affect your build.
FastStore Analyzer is a static analysis tool that helps maintain code quality and security in FastStore projects. Integrated into your development workflow with customizable CLI hooks, FastStore Analyzer scans your codebase to identify issues before they affect your build.

- `preDev`: Runs before the development server starts.
- `postDev`: Runs after the development server starts.

>ℹ Hooks are defined in the `src/hooks` folder and are executed according to the file name (example: `pre.ts` will run before `post.ts`).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [Grammar reviewer] reported by reviewdog 🐶
Using 'e.g.' (exempli gratia) or 'For example,' is more formal and standard in technical documentation than 'example:'.

Suggested change
>ℹ Hooks are defined in the `src/hooks` folder and are executed according to the file name (example: `pre.ts` will run before `post.ts`).
>ℹ Hooks are defined in the `src/hooks` folder and are executed according to the file name (e.g., `pre.ts` will run before `post.ts`).


| Field | Type | Description |
|:------|:-----|:------------|
| `filePattern` | `string` | Glob pattern defining the files to be analyzed (example: `.{js,ts,jsx,tsx,css,less,scss}`). **Replace `{{your-module}}` based on your scenario.** |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [Grammar reviewer] reported by reviewdog 🐶
Using 'e.g.' (exempli gratia) or 'For example,' is more formal and standard in technical documentation than 'example:'.

Suggested change
| `filePattern` | `string` | Glob pattern defining the files to be analyzed (example: `.{js,ts,jsx,tsx,css,less,scss}`). **Replace `{{your-module}}` based on your scenario.** |
| `filePattern` | `string` | Glob pattern defining the files to be analyzed (e.g., `.{js,ts,jsx,tsx,css,less,scss}`). **Replace `{{your-module}}` based on your scenario.** |

|:------|:-----|:------------|
| `filePattern` | `string` | Glob pattern defining the files to be analyzed (example: `.{js,ts,jsx,tsx,css,less,scss}`). **Replace `{{your-module}}` based on your scenario.** |
| `cssOptions` | `object` | Options for validating and transforming CSS namespace usage. |
|   ├─`allowedNamespaces` | `string` | Array of allowed CSS namespace prefixes (example: `['extension-']`). Only selectors with these prefixes will be considered compliant. |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [Grammar reviewer] reported by reviewdog 🐶
Using 'e.g.' (exempli gratia) or 'For example,' is more formal and standard in technical documentation than 'example:'.

Suggested change
|   ├─`allowedNamespaces` | `string` | Array of allowed CSS namespace prefixes (example: `['extension-']`). Only selectors with these prefixes will be considered compliant. |
|   ├─`allowedNamespaces` | `string` | Array of allowed CSS namespace prefixes (e.g., `['extension-']`). Only selectors with these prefixes will be considered compliant. |

| `cssOptions` | `object` | Options for validating and transforming CSS namespace usage. |
|   ├─`allowedNamespaces` | `string` | Array of allowed CSS namespace prefixes (example: `['extension-']`). Only selectors with these prefixes will be considered compliant. |
|   ├─`transformNonCompliant` | `boolean` | If `true`, automatically updates non-compliant CSS selectors to match the expected namespace format. |
|   ├─`defaultNamespace` | `string` | Default namespace prefix applied to selectors when auto-fixing non-compliant CSS (example: ` 'extension-'`. |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [Grammar reviewer] reported by reviewdog 🐶
Using 'e.g.' (exempli gratia) or 'For example,' is more formal and standard in technical documentation than 'example:'. Also, removed an unnecessary space before the single quote for better typography.

Suggested change
|   ├─`defaultNamespace` | `string` | Default namespace prefix applied to selectors when auto-fixing non-compliant CSS (example: ` 'extension-'`. |
|   ├─`defaultNamespace` | `string` | Default namespace prefix applied to selectors when auto-fixing non-compliant CSS (e.g., `'extension-'`). |

| `cssOptions` | `object` | Options for validating and transforming CSS namespace usage. |
|   ├─`allowedNamespaces` | `string` | Array of allowed CSS namespace prefixes (example: `['extension-']`). Only selectors with these prefixes will be considered compliant. |
|   ├─`transformNonCompliant` | `boolean` | If `true`, automatically updates non-compliant CSS selectors to match the expected namespace format. |
|   ├─`defaultNamespace` | `string` | Default namespace prefix applied to selectors when auto-fixing non-compliant CSS (example: ` 'extension-'`. |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[markdownlint-fix] reported by reviewdog 🐶

Suggested change
|   ├─`defaultNamespace` | `string` | Default namespace prefix applied to selectors when auto-fixing non-compliant CSS (example: ` 'extension-'`. |
|   ├─`defaultNamespace` | `string` | Default namespace prefix applied to selectors when auto-fixing non-compliant CSS (example: `'extension-'`. |

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants