angular/contributing-docs
Alex Rickabaugh 4821239c41 refactor: add g3-only and 3p-only markers to replace specific g3 patches
Replace specific file patches applied during google3 sync with generic comment-based mechanisms.

By adding `// g3-only` prefix comments to g3-specific exports and declarations, and appending `// 3p-only` context to `@internal` tags, we enable generic tooling to handle these modifications during the sync process.

Additionally, wrap 3rd-party-only imports and exports (which should be stripped in google3) with `// 3p-only-start` and `// 3p-only-end` comment markers.

This reduces the need for maintaining custom file-specific patches in google3.

Also, add a comprehensive guide to these sync comment markers in `contributing-docs/google-markers.md` to assist external contributors.

Specifically:
- Add `// 3p-only` context to `@internal` in `directives.ts` for `foreignImports` and `deferredImports`.
- Add `// g3-only` commented exports in `core.ts`.
- Add `// g3-only-start`/`// g3-only-end` commented global declaration block in `zone.ts`.
- Wrap 3p-only imports in `fake_navigation.ts` with `// 3p-only-start` and `// 3p-only-end`.
- Wrap 3p-only exports in `compiler-cli/index.ts` with `// 3p-only-start` and `// 3p-only-end`.
- Add `// g3-only` and `// 3p-only` markers to `shared.ts` for `setDisabledStateDefault` configuration.
- Add `// g3-only` and `// 3p-only` markers to `feature_detection.ts` for semver dependency.
- Add `// g3-only` and `// 3p-only` markers to `domino_adapter.ts` for domino import path.
- Add `// 3p-only` marker to `ng_dev_mode` import in `event_dispatcher.ts`.
- Add `// g3-only` and `// 3p-only` markers to `MOUSE_SPECIAL_SUPPORT` in `event_contract_defines.ts`.
- Add `// g3-only` and `// 3p-only` markers to `BrowserModule` imports in `module.ts` (animations) and `browser.ts` (testing).
- Add `// 3p-only` marker to `goog.d.ts` reference tags in `util.ts` (platform-browser), `types.d.ts`, `ng_i18n_closure_mode.ts`, `tokens.ts`, and `global_utils.ts`.
- Wrap `Default` enum value of `ChangeDetectionStrategy` in `constants.ts` with `// 3p-only-start` and `// 3p-only-end`.
- Add `// g3-only` and `// 3p-only` markers to `LEGACY_OPTIONAL_CHAINING_DEFAULT` in `legacy_optional_chaining_default.ts` and `legacyOptionalChaining` in `directive.ts`.
- Add `// g3-only` and `// 3p-only` markers to `DEFAULT_PARAMS_INHERITANCE_STRATEGY` in `router_state.ts`.
- Add `// g3-only` and `// 3p-only` (and block variants) markers to `@mcp-b/webmcp-types` imports in `declare_tool.ts`, `provide_tools.ts`, and `types.ts`.
- Add `contributing-docs/google-markers.md` guide.

TAG=agy
CONV=cd09a4f3-869a-4f41-949b-c91f1b8f1c51
2026-05-22 16:22:35 -07:00
..
images docs: update and reorganize contributor docs (#56141) 2024-06-11 08:20:59 -07:00
auto-issue-locking.md docs: update and reorganize contributor docs (#56141) 2024-06-11 08:20:59 -07:00
branches-and-versioning.md docs: fix typos and grammar errors across documentation 2026-04-08 09:40:47 -07:00
building-and-testing-angular.md docs: normalize product name casing across docs 2026-05-07 16:09:44 -06:00
building-with-bazel.md build: format md files 2025-11-06 10:03:05 -08:00
caretaking.md docs: fix typos and grammar errors across documentation 2026-04-08 09:40:47 -07:00
coding-standards.md ci: reformat files 2025-12-16 14:44:19 -08:00
commit-message-guidelines.md ci: remove remainings of saucelabs tests 2026-04-22 14:41:03 -07:00
debugging-tips.md ci: reformat files 2025-12-16 14:44:19 -08:00
dev_preview_and_experimental.md build: format md files 2025-11-06 10:03:05 -08:00
documentation-authoring.md docs: fix typos and grammar errors across documentation 2026-04-08 09:40:47 -07:00
feature-request-consideration.md docs: fixed grammar and spelling errors in contributing-docs folder (#62196) 2025-06-24 09:39:07 +00:00
google-markers.md refactor: add g3-only and 3p-only markers to replace specific g3 patches 2026-05-22 16:22:35 -07:00
public-api-surface.md build: format md files 2025-11-06 10:03:05 -08:00
running-benchmarks.md build: use pnpm as the package manager instead of yarn (#62924) 2025-07-31 22:06:27 +00:00
saved-issue-replies.md docs: normalize product name casing across docs 2026-05-07 16:09:44 -06:00
spam.md docs: normalize product name casing across docs 2026-05-07 16:09:44 -06:00
triage-and-labelling.md docs: fix typos and grammar errors across documentation 2026-04-08 09:40:47 -07:00
using-fixup-commits.md docs: fix typos and grammar errors across documentation 2026-04-08 09:40:47 -07:00