12: Delete all tutorials - #3384
Merged
Merged
Conversation
Removes the custom field type tutorial, the beginner website tutorial, and the page-and-form tutorial in full (25 pages, 46 images/assets), along with the Tutorials navigation section in mkdocs.yml. A replacement SaaS getting-started tutorial is separate work. Fixes every inbound link left dangling by the deletion, including the front page's primary "Beginner tutorial" entry tile (docs/index.md), which is removed while leaving the remaining two tiles as a coherent entry-point row. Judgement calls, per the ticket notes: - docs/users/user_registration.md is kept (it has substantial content beyond the dead link) with its procedure link replaced by a pointer to the anonymous user/register policy. - docs/content_management/images/add_image_asset_from_dam.md now points at Page blocks instead of the deleted tutorial step. - docs/content_management/pages/ibexa_connect_scenario_block.md keeps its profiler caution but drops the tutorial setup instruction. - docs/content_management/content_management_guide.md drops the custom-field-type clause outright (not a SaaS capability). - Three further dangling links were found beyond the ticket's list, in referrer pages slated for deletion by other in-flight tickets (09, 11) that haven't merged into this branch yet: fixed here too so this branch's build stays green independently. PYTHONPATH=tools ~/python/bin/python3.13 -m mkdocs build --strict: exit 0 PYTHONPATH=tools ~/python/bin/python3.13 -m pytest -q: 95 passed Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Ticket 12 of the Cohesivo SaaS conversion. Base:
saas-batch-3.Deletes all three tutorials. Every one of them opens by asking for a local
installation and ends by writing a template or a PHP class, none of which a
Cohesivo tenant can do. All three go rather than being partially stripped: a
tutorial that no longer reaches a working result is worse than no tutorial.
A replacement SaaS getting-started tutorial is separate work, explicitly out of
scope here.
Changes
docs/tutorials/in full — beginner,page-and-form, generic field type, and the landing page) plus 46 images and
assets used only by them, each checked for other referrers first.
mkdocs.yml.The front page
The front page's primary entry tile pointed at the beginner tutorial, so it is
gone. The remaining "APIs" and "First steps" tiles still form a coherent row —
the ticket requires the page stay coherent, not that it be rebuilt, and the full
rebuild is ticket 19's job. No redesign was attempted here.
Judgement calls
docs/users/user_registration.mdwas kept, not deleted. Beyond the deadtutorial link it carries real content — user types, groups, form
configuration, password templates — so only the link was replaced, with a
pointer to the anonymous
user/registerpolicy.ibexa_connect_scenario_block.md: only the tutorial sentence was dropped. Thenotes suggested removing the whole admonition, but it also carried an
unrelated profiler caution worth keeping.
add_image_asset_from_dam.mdwas repointed atpage_blocks.md;content_management_guide.mdlost its custom-field-type clause outright.Three links fixed beyond the ticket's list
The notes flagged three dangling links as "referrer deleted by ticket 09/11".
Those tickets have not merged yet, so on this branch the links were live and
would have failed
--strict. All three are fixed here(
create_custom_generic_field_type.md,extend_image_editor.md,project_organization.md), which keeps this branch green standalone and is ano-op once 09 and 11 delete those files.
Verification
mkdocs build --strict→ exit 0.pytest -q→ 95 passed (this branch predates ticket 01's five new tests).site/for tutorial paths: no leftover internal links. Theonly hits are an external
doctrine-project.org/.../tutorials/...URL.invariants-baseline.yamluntouched, no new files underdocs/, and themkdocs.ymledit is confined to the Tutorials block so it merges cleanlyalongside the sibling deletion tickets.
🤖 Generated with Claude Code