Skip to content

12: Delete all tutorials - #3384

Merged
mnocon merged 1 commit into
saas-batch-3from
saas-t12-tutorials
Sep 7, 2026
Merged

12: Delete all tutorials#3384
mnocon merged 1 commit into
saas-batch-3from
saas-t12-tutorials

Conversation

@mnocon

@mnocon mnocon commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

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

  • 71 files deleted: 25 pages (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.
  • The Tutorials nav section is removed from mkdocs.yml.
  • 10 surviving pages had inbound links removed.

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.md was kept, not deleted. Beyond the dead
    tutorial 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/register policy.
  • ibexa_connect_scenario_block.md: only the tutorial sentence was dropped. The
    notes suggested removing the whole admonition, but it also carried an
    unrelated profiler caution worth keeping.
  • add_image_asset_from_dam.md was repointed at page_blocks.md;
    content_management_guide.md lost 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 a
no-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).
  • Grep of the built site/ for tutorial paths: no leftover internal links. The
    only hits are an external doctrine-project.org/.../tutorials/... URL.

invariants-baseline.yaml untouched, no new files under docs/, and the
mkdocs.yml edit is confined to the Tutorials block so it merges cleanly
alongside the sibling deletion tickets.

🤖 Generated with Claude Code

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>
@github-actions

github-actions Bot commented Sep 7, 2026

Copy link
Copy Markdown

Preview of modified files

Preview of modified Markdown:

@mnocon
mnocon merged commit 47cfa09 into saas-batch-3 Sep 7, 2026
7 of 11 checks passed
@mnocon
mnocon deleted the saas-t12-tutorials branch September 7, 2026 13:12
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