Talking Drupal #427 - Melissa Turns The Tables

On today’s show we are turning the tables and Nic and John will
be interviewed by our guest host Melissa Bent. We’ll also cover
Content Model Documentation as our module of the week.


For show notes visit:
www.talkingDrupal.com/427
Topics

What made you decide to start the podcast

Who does what tasks

The first episode was on May 30 2013. What do you know now
that you wish you knew then

When did the guest host start

What has been your favorite episode

How did you come to this format

Where did the tagline come from

What technology do you use in production

The show is supported by multiple platforms, would you
recommend this

What advice would you give someone just starting

Resources

GovCon Session for Content Model Documentation

First Episode

Three hundred

The Night before DrupalCon

Wade Wingler

Jono Bacon

Dries’ First Episode

Needs Review Issue Queue

Sustainability Guidelines

A Website’s Carbon Footprint

vdo.ninja

kdenlive

Audacity

Patreon

Youtube

Libsyn

Kid3

Auphonic

Midjourney

Trello

Hackmd.io

Guests

Nic Laflin - nLighteneddevelopment.com nicxvan
John Picozzi - epam.com johnpicozzi
Hosts

Melissa Bent - linkedin.com/in/melissabent merauluka
MOTW Correspondent

Martin Anderson-Clutz - @mandclu
Content Model & Site Documentation


Brief description:

Have you wanted to make your Drupal site self-documenting
directly within the admin UI? There’s a module for that.



Brief history

How old: created in Jan 2023

Versions available: 1.0.23, compatible with Drupal 9 and
10



Maintainership

Actively maintained, latest release was a week ago

Test coverage

No official guide, but there was a recent talk about the
module at GovCon, so you can watch that

Number of open issues: 43 open, 9 of which are bugs



Usage stats:

82 sites



Maintainer(s):

Steve Wirt (swirt) who works for Civic Actions



Module features and usage

Allows your Drupal site to generate its own documentation

Has fieldable Content Model Document entities that allow
you to customize what data will be stored

Can optionally document things like your content types,
taxonomies, block types, paragraph types, and more

Documentation elements can also be associated with parts
of your site configuration, and they become available within
the relevant parts of your admin UI. For example, if you add
documentation for a specific content type, when a site
builder goes into edit that content type they will see a link
to the documentation as a tab

You can generate entity relationship diagrams using
MermaidJS

Also includes a field search capability originally
developed as a separate module by Matthieu Scarset, who was a
guest on this show back in episode #298

Will also generate diagrams to illustrate your content
workflows, showing the states defined and the transitions
between them