Skip to content

Deprecate separate title attribute in flows; derive from description#1472

Draft
Copilot wants to merge 3 commits intomainfrom
copilot/deprecate-title-attribute-in-flows
Draft

Deprecate separate title attribute in flows; derive from description#1472
Copilot wants to merge 3 commits intomainfrom
copilot/deprecate-title-attribute-in-flows

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 9, 2026

Flow YAML files required a redundant top-level title attribute even when the description already began with a Markdown heading—unlike flow pages and static-page chunks, which derive their title from markup automatically.

Changes

  • FlowDesc.title — changed from required str to str | None = None
  • FlowDesc.check_title validator — issues a deprecation warning via the validation context when title is explicitly supplied and extract_title_from_markup(description) would have yielded a result; raises ValueError when neither source provides a title
  • FlowDesc.get_title() — new method mirroring ChunkDesc.get_title(): returns title if set, otherwise extracts from description
  • models.py and 5 flow templates — updated all flow_desc.title accesses to flow_desc.get_title() / flow_desc.get_title

Example

A flow description that previously required both:

title: "Quiz 1"
description: |
  # Quiz 1
  ...

can now omit title entirely:

description: |
  # Quiz 1
  ...

Keeping both will produce a validation warning pointing authors to remove the redundant attribute.

Copilot AI linked an issue Apr 9, 2026 that may be closed by this pull request
Copilot AI and others added 2 commits April 9, 2026 21:45
Copilot AI changed the title [WIP] Deprecate separate title attribute in flows Deprecate separate title attribute in flows; derive from description Apr 9, 2026
Copilot AI requested a review from inducer April 9, 2026 21:48
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.

Deprecate separate title attribute in flows

2 participants