Skip to content

Content patches: CND-side comprehension — validate sweep, docs matrix, CND-diff scaffolding (P5) #729

Description

@romain-pm

Sub-issue of #725 (P5). Addresses the second review point on #697: the framework does not, by itself, make it easier on the CND side to understand the migration process. With the engine in Java (#697), the answers are language-neutral and serve Java and JS modules alike.

Scope

  • Docs matrix: a guide section mapping each CND change to the operation it requires — property dropped → removePropertyValues, property added with a default → setPropertyValues, property type changed → convertPropertyValues, type retired → removeNodeType, type renamed → changeNodeType — and, just as important, which CND changes need no patch. Can start immediately.
  • validate sweep: a content-vs-definitions divergence report in the Java framework (per module: leftover values of properties no longer defined, instances of unregistered types, stored values whose type no longer matches the definition), exposed through the P4 GraphQL/CLI surfaces (content-patches validate).
  • CND-diff-aware scaffolding (candidate): extend P4's create scaffolding to read the definitions diff between the deployed and the local CND and suggest the patch skeleton.

Dependencies

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions