oliverdavies.uk/content/node.dab13df7-2835-407a-90c5-f5574585718b.json

{
    "uuid": [
        {
            "value": "dab13df7-2835-407a-90c5-f5574585718b"
        }
    ],
    "langcode": [
        {
            "value": "en"
        }
    ],
    "type": [
        {
            "target_id": "daily_email",
            "target_type": "node_type",
            "target_uuid": "8bde1f2f-eef9-4f2d-ae9c-96921f8193d7"
        }
    ],
    "revision_timestamp": [
        {
            "value": "2025-05-11T09:00:07+00:00"
        }
    ],
    "revision_uid": [
        {
            "target_type": "user",
            "target_uuid": "b8966985-d4b2-42a7-a319-2e94ccfbb849"
        }
    ],
    "revision_log": [],
    "status": [
        {
            "value": true
        }
    ],
    "uid": [
        {
            "target_type": "user",
            "target_uuid": "b8966985-d4b2-42a7-a319-2e94ccfbb849"
        }
    ],
    "title": [
        {
            "value": "Diagram-driven development"
        }
    ],
    "created": [
        {
            "value": "2024-09-04T00:00:00+00:00"
        }
    ],
    "changed": [
        {
            "value": "2025-05-11T09:00:07+00:00"
        }
    ],
    "promote": [
        {
            "value": false
        }
    ],
    "sticky": [
        {
            "value": false
        }
    ],
    "default_langcode": [
        {
            "value": true
        }
    ],
    "revision_translation_affected": [
        {
            "value": true
        }
    ],
    "path": [
        {
            "alias": "\/daily\/2024\/09\/04\/diagram-driven-development",
            "langcode": "en"
        }
    ],
    "body": [
        {
            "value": "\n          <p>You've heard of README-driven development, where you start by writing a README and documenting what you're going to code you start coding.<\/p>\n\n<p>I've recently been doing diagram-driven development, where I start with a diagram and build a flow chart of the functionality, what pieces I'll need and what the information flow or user journey looks like.<\/p>\n\n<p><a href=\"\/daily\/2024\/08\/18\/mermaid-markdown-for-charts\">I've been using Mermaid<\/a>, so the diagrams are easy and quick to create, are version-controlled and a stored in the same code repository.<\/p>\n\n<p>You can see an example in the <a href=\"https:\/\/github.com\/opdavies\/build-configs\/tree\/f02fce7ff5b5cff202ec8b893a4b3c7e7c56f3c4\/docs\">Build Configs repository<\/a>, which is <a href=\"\/daily\/2024\/08\/27\/build-configs-is-open-source\">now public and open-source<\/a>.<\/p>\n\n<p>Similar to writing the README first, creating a diagram upfront helps me clarify what I'm going to build and how I'm going to do it.<\/p>\n\n<p>And using Mermaid means I can create it and push a temporary branch or create a pull or merge request to share it with colleagues to review before I start.<\/p>\n\n        ",
            "format": "full_html",
            "processed": "\n          <p>You've heard of README-driven development, where you start by writing a README and documenting what you're going to code you start coding.<\/p>\n\n<p>I've recently been doing diagram-driven development, where I start with a diagram and build a flow chart of the functionality, what pieces I'll need and what the information flow or user journey looks like.<\/p>\n\n<p><a href=\"http:\/\/default\/daily\/2024\/08\/18\/mermaid-markdown-for-charts\">I've been using Mermaid<\/a>, so the diagrams are easy and quick to create, are version-controlled and a stored in the same code repository.<\/p>\n\n<p>You can see an example in the <a href=\"https:\/\/github.com\/opdavies\/build-configs\/tree\/f02fce7ff5b5cff202ec8b893a4b3c7e7c56f3c4\/docs\">Build Configs repository<\/a>, which is <a href=\"http:\/\/default\/daily\/2024\/08\/27\/build-configs-is-open-source\">now public and open-source<\/a>.<\/p>\n\n<p>Similar to writing the README first, creating a diagram upfront helps me clarify what I'm going to build and how I'm going to do it.<\/p>\n\n<p>And using Mermaid means I can create it and push a temporary branch or create a pull or merge request to share it with colleagues to review before I start.<\/p>\n\n        ",
            "summary": null
        }
    ]
}