Document null page titles and the 422 on route generation without a title
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 70/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Domain
- api, database, documentation
Research direction
Start with the linked bundle PR components-web-app/api-components-bundle#440 to confirm the behaviour: title defaulting to null on Page and AbstractPageData, the 422 from POST /_/routes/generate, and the CwaFixtureBuilder changes. Then document these in the docs, including the Doctrine migration and the two SQL UPDATE statements, with a note to use the configured table_prefix. Done when each of the four sections is written and the SQL matches the table names the bundle uses.
Written by the indexing model from the issue text.
Description
Bundle PR: components-web-app/api-components-bundle#440 (fixes components-web-app/api-components-bundle#439)
Please document the following.
A page's title defaults to null
A Page or page data (AbstractPageData) created without a title now stores and returns title: null. It used to be 'Unnamed Page'. Page data's title column is now nullable, as the page's already was. Front ends can tell an untitled page apart from a chosen title, so a page data with no title can fall back to its page template's title.
Route generation needs a title
POST /_/routes/generate for a page or page data with no title, or with a title that gives no slug (for example only punctuation), returns 422 with one violation on title: "A title is needed to generate a route." Nothing is created, and an existing route is not turned into a redirect. Before this change it generated /unnamed-page. Explicit route creation (POST /_/routes) is unaffected.
CwaFixtureBuilder: a page or page data with no route: and no title gets no route, top-level or nested. In an --append load, untitled page data with no route: is identified like withoutRoute() page data: it is created only with its template or parent.
Upgrade step
Generate and run a Doctrine migration. It makes _acb_abstract_page_data.title nullable. Then clear the old default:
UPDATE _acb_page SET title = NULL WHERE title = 'Unnamed Page';
UPDATE _acb_abstract_page_data SET title = NULL WHERE title = 'Unnamed Page';
Replace _acb_ with the configured table_prefix if it differs.
- Dominant language
- Vue
- Stars
- 0
- Forks
- 0
- PR merge metrics
- No merged PRs in 30d
Getting set up
This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from components-web-app/docs
-
Document opening the add page data form with defaults (?parentPage, ?parentPageData, ?template)Opendocumentation
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
components-web-app/docs#230 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
components-web-app/docs#228 · 1 comment ·
-
Difficulty 3/5 Half a day Newbie friendliness 58/100
components-web-app/docs#229 ·
-
documentation
Difficulty 3/5 1-3 hours Newbie friendliness 25/100
components-web-app/docs#226 ·
-
Website copy: inaccurate infrastructure claims, typos, a broken link and commented-out leftoversOpenenhancement
Difficulty 3/5 1-2 days Newbie friendliness 62/100
components-web-app/docs#175 ·
All issues in components-web-app/docs
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
cmlarsen/writemorebetter#158 ·
Maintainers usually reply within 1 day
-
Notifications pagination accepts NaN and negative LIMIT/OFFSETPossibly taken @Senthil455 claimed this today. OpenBUGS MEDIUM
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
elixpo/blogs.elixpo#419 · 2 comments ·
Maintainers usually reply within 1 day
-
[Bug]: agent_final_response still returns the abandoned branch's answer after navigate moves HEAD backPossibly taken @enyst claimed this today. Openbug priority:low ready-for-dev
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
OpenHands/software-agent-sdk#5822 ·
Maintainers usually reply within 1 day
-
area: server enhancement good first issue
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
scs0209/laya-guard#52 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
Maintainers usually reply within 1 day