Skip to content

PageObject retirement keys and the two unlinked-Feature conditions - #45

Merged
miroslavpojer merged 1 commit into
masterfrom
docs/pageobject-retirement-keys
Oct 1, 2026
Merged

miroslavpojer merged 1 commit into
masterfrom
docs/pageobject-retirement-keys

Conversation

@miroslavpojer

Copy link
Copy Markdown
Collaborator

DEC-47 keeps deprecation_reason and superseded_by authored on a Feature, but the canon disagreed on where. The common-mistakes row and examples_check (which already reads both keys from a full header to mark a Feature retiring) put them on a PageObject header; section 2's field table and the glossary's "where authored" note left them out.

The canon also called a Feature with user_stories: none "orphan", and the tools turned that word into one code for two conditions (DEC-48). The canon now names the condition in words and restates no tool code.

  • header types, section 2: deprecation_reason and superseded_by as optional full-header fields that drive no state; both join the cross-reference header's intentionally omitted list
  • glossary: the two PageObject keys named next to the issue-body headings and the feature-file keys
  • header types: "orphan(ed)" becomes "with no User Story" in the adoption table, the user_stories row and the maintenance note
  • examples_check unchanged: it already accepts both keys

DEC-47 keeps deprecation_reason and superseded_by authored on a Feature,
but the canon disagreed on where. The common-mistakes row and
examples_check (which already reads both keys from a full header to mark
a Feature retiring) put them on a PageObject header; section 2's field
table and the glossary's "where authored" note left them out.

The canon also called a Feature with `user_stories: none` "orphan", and
the tools turned that word into one code for two conditions (DEC-48).
The canon now names the condition in words and restates no tool code.

- header types, section 2: deprecation_reason and superseded_by as
  optional full-header fields that drive no state; both join the
  cross-reference header's intentionally omitted list
- glossary: the two PageObject keys named next to the issue-body
  headings and the feature-file keys
- header types: "orphan(ed)" becomes "with no User Story" in the
  adoption table, the user_stories row and the maintenance note
- examples_check unchanged: it already accepts both keys
@miroslavpojer
miroslavpojer merged commit ba27a4c into master Oct 1, 2026
4 of 6 checks passed
@miroslavpojer
miroslavpojer deleted the docs/pageobject-retirement-keys branch October 1, 2026 13:31
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.

1 participant