Audit documentation against rushstack implementations; add missing plugin docs, config options, and fix stale references

[Copilot]

Systematic cross-reference of all documentation sites against microsoft/rushstack and microsoft/tsdoc source code to identify undocumented features, stale URLs, and incorrect defaults.

Stale GitHub branch references (24 files)

• Updated microsoft/tsdoc and microsoft/rushstack URLs from /master/ to /main/ across api-extractor.com and rushjs.io docs
• Left faastjs/faast.js URLs on /master/ (verified still correct)

API Extractor: undocumented config options

• apiReport.tagsToReport — controls which TSDoc tags appear in API report files
• docModel.releaseTagsToTrim — controls which release tags are excluded from .api.json
• ae-undocumented message page — diagnostic for missing doc comments (disabled by default)
• Fixed extractorMessageReporting defaults table — was missing ae-internal-mixed-release-tag, ae-undocumented, ae-wrong-input-file-type

Heft: new plugin and authoring docs

• Rspack plugin (rspack.md) — @rushstack/heft-rspack-plugin shipped but undocumented
• Isolated transpile plugin (isolated-transpile.md) — @rushstack/heft-isolated-typescript-transpile-plugin (SWC transpiler) undocumented
• Authoring plugins guide (advanced/authoring-plugins.md) — covers heft-plugin.json manifest, IHeftTaskPlugin, task hooks, watch mode, CLI parameters, options schema, inter-plugin communication

Rush plugin authoring

• Added lifecycle hooks reference table — all 8 hooks from RushLifecycleHooks
• Added RushSession service registration APIs (registerCloudBuildCacheProviderFactory, registerCobuildLockProviderFactory)
• Removed stale "(experimental)" labels from plugin page titles

// Example from new Rush hooks docs
rushSession.hooks.runPhasedCommand.for('build').tapPromise(
  this.pluginName,
  async (command: IPhasedCommand) => {
    const logger = rushSession.getLogger(this.pluginName);
    logger.terminal.writeLine('The "rush build" command is about to run!');
  }
);

Rush plugin inventory

• Added rush-buildxl-graph-plugin (published but missing from table)
• Noted rush-azure-interactive-auth-plugin as secondary plugin in Azure package
• Marked built-in plugins with "(ships built-in)" — added rush-http-build-cache-plugin to built-in note (was missing alongside S3 and Azure)
• Added 4 previously undocumented plugins to table: rush-bridge-cache-plugin, rush-http-build-cache-plugin, rush-redis-cobuild-plugin, rush-resolver-cache-plugin

---

🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.