Talking Drupal #427 - Melissa Turns The Tables

Dec 4, 2023

Ask episode

Chapters

Transcript

Episode notes

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 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