Proposal

The d.o infrastructure (gitlab_templates) and gitlab supports generating docs pages with docs page builders.

I propose to discuss the possibility of using this feature instead of d.o. documentation pages.
The obvious benefit is that the feature can allow keep the documents in the codebase and creating them using mkdocs.

Details

CommentFileSizeAuthor
#8 Capture d’écran 2025-12-08 à 09.51.11.png492.77 KBmably

Issue fork domain-3472433

Command icon Show commands

Start within a Git clone of the project using the version control instructions.

Or, if you do not have SSH keys set up on git.drupalcode.org:

About issue forks

Comments

davps created an issue. See original summary.

mably’s picture

mably commented
Status: Active » Postponed (maintainer needs more info)

What is the plan?

mably’s picture

mably commented
Category: Feature request » Task

mably opened merge request !284

mably’s picture

mably commented

Looks like we need to switch the default branch to 3.x to enable auto-generation of the documentation pages: #3426667: Add MkDocs.

mably’s picture

mably commented
Issue summary: View changes
mably’s picture

mably commented
Status: Postponed (maintainer needs more info) » Needs review
mably’s picture

mably commented
StatusFileSize
new Capture d’écran 2025-12-08 à 09.51.11.png492.77 KB

Tried to generate MkDocs using the README.md file as index.md:

Generated Mkdocs

  • mably committed 77490717 on 3.x 
    Issue #3472433 by davps, mably: Move/recreate documentation using mkdocs
mably’s picture

mably commented
Version: 2.0.x-dev » 3.x-dev
Status: Needs review » Fixed

Mkdocs documentation has been deployed on Gitlab pages:

https://project.pages.drupalcode.org/domain/

Now it just needs to be updated 😉

Now that this issue is closed, review the contribution record.

As a contributor, attribute any organization that helped you, or if you volunteered your own time.

Maintainers, credit people who helped resolve this issue.

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.