Skip to content

Publish migration guidance for downstream users affected by explicit feature management #81

Description

@nradakovic

What

Publish migration guidance for downstream users who may rely on behavior previously provided implicitly by Bazel legacy features.

The goal is to help consumers understand the impact of the explicit-feature model and what actions may be required in their workspaces.

Acceptance Criteria (DoD)

  • A migration document or release-note style guide exists for downstream users.
  • The documentation explains the impact of enabling no_legacy_features.
  • The documentation identifies behaviors that are no longer implicitly available.
  • The documentation explains how consumers can restore supported behavior explicitly when needed.
  • The guidance is clear enough to support downstream adoption without source-code archaeology.

How

  • Summarize the behavioral differences introduced by the explicit-feature model.
  • Identify which previously implicit behaviors remain supported explicitly and which do not.
  • Provide examples showing how consumers can register additional feature definitions via extra_known_features or extra_enabled_features.
  • Include common migration scenarios where concrete examples would reduce support burden.
  • Publish the migration guidance alongside the feature documentation and extension API material.

Out of Scope

  • One-off migration support for individual downstream repositories.
  • Feature implementation work.
  • CI or test infrastructure changes.

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationp3Medium/Low - handle it within normal process

Type

Fields

No fields configured for Task.

Projects

Status
No status
Status
Ready

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions