uuid:
  - value: 021e00c1-b813-4edd-8064-71285bc3647d
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:10+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: 'Recording architectural decisions'
created:
  - value: '2024-06-12T00:00:00+00:00'
changed:
  - value: '2025-05-11T09:00:10+00:00'
promote:
  - value: false
sticky:
  - value: false
default_langcode:
  - value: true
revision_translation_affected:
  - value: true
path:
  - alias: /daily/2024/06/12/recording-architectural-decisions
    langcode: en
body:
  - value: |
      <p>I recently <a href="https://x.com/StefanGalescu/status/1798421063355007017">saw this post on X</a>, talking about an open-source project.</p>

      <p>This was the part that I want to highlight:</p>

      <blockquote>
        <p>I was also impressed by the decisions documents. More projects should implement this concept.</p>
      </blockquote>

      <p>Looking at the repository, it contains records of 36 decisions made on the project between May 2023 and April 2024.</p>

      <p>Decision records provide useful information to new people to a project, whether you want to contribute to an open-source project or it's a new client or work codebase.</p>

      <p>The code and project will likely continue once you've finished working on it, so capturing decisions for future Developers is key.</p>

      <p>I've often joined projects and wondered why or how something was done, and can only guess as the decision wasn't recorded or is somewhere not available to me, such as an old wiki or ticketing system.</p>

      <h2 id="here%27s-the-thing">Here's the thing</h2>

      <p>I agree with the poster.</p>

      <p>More people should record the decisions made on their project, whether it's open-source or not.</p>

              
    format: full_html
    processed: |
      <p>I recently <a href="https://x.com/StefanGalescu/status/1798421063355007017">saw this post on X</a>, talking about an open-source project.</p>

      <p>This was the part that I want to highlight:</p>

      <blockquote>
        <p>I was also impressed by the decisions documents. More projects should implement this concept.</p>
      </blockquote>

      <p>Looking at the repository, it contains records of 36 decisions made on the project between May 2023 and April 2024.</p>

      <p>Decision records provide useful information to new people to a project, whether you want to contribute to an open-source project or it's a new client or work codebase.</p>

      <p>The code and project will likely continue once you've finished working on it, so capturing decisions for future Developers is key.</p>

      <p>I've often joined projects and wondered why or how something was done, and can only guess as the decision wasn't recorded or is somewhere not available to me, such as an old wiki or ticketing system.</p>

      <h2 id="here%27s-the-thing">Here's the thing</h2>

      <p>I agree with the poster.</p>

      <p>More people should record the decisions made on their project, whether it's open-source or not.</p>

              
    summary: null
field_daily_email_cta: {  }