oliverdavies.uk/content/node.b3a28a86-02c5-45ea-8a51-32508cd34b7d.yml

80 lines
3.6 KiB
YAML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

uuid:
- value: b3a28a86-02c5-45ea-8a51-32508cd34b7d
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:06+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: 'Drupal adopts ADRs'
created:
- value: '2024-09-21T00:00:00+00:00'
changed:
- value: '2025-05-11T09:00:06+00:00'
promote:
- value: false
sticky:
- value: false
default_langcode:
- value: true
revision_translation_affected:
- value: true
path:
- alias: /daily/2024/09/21/drupal-adopts-adrs
langcode: en
body:
- value: |
<p>Today I noticed that Drupal's Experience Builder project <a href="https://www.drupal.org/project/experience_builder/issues/3454669">has adopted architectural decision records</a>.</p>
<p>From the issue:</p>
<blockquote>
<p>I proposed [...] to start adopting ADRs to document decisions that were made. Thatd allow us to stop rehashing past conversations and allow people to onboard with fewer meetings.
… or so I think.
Because I think that ADRs could be an excellent way to scale this project up to A) many people, B) many timezones.</p>
</blockquote>
<p>I like this decision and have adopted and <a href="/daily/2024/06/12/recording-architectural-decisions">written about ADRs before</a>.</p>
<p>I also like that the documents <a href="https://git.drupalcode.org/project/experience_builder/-/tree/0.x/docs/adr?ref_type=heads">are stored as markdown files in the repository</a>, alongside the code, making it easy for everyone to view or change.</p>
<p>As the work on Experience Builder continues, new contributors can read these documents and understand why previous decisions were made, which is extremely valuable.</p>
<p>I'm interested to see how ADRs work for the Experience Builder project and whether they're adopted more widely in other parts of the Drupal ecosystem.</p>
format: full_html
processed: |
<p>Today I noticed that Drupal's Experience Builder project <a href="https://www.drupal.org/project/experience_builder/issues/3454669">has adopted architectural decision records</a>.</p>
<p>From the issue:</p>
<blockquote>
<p>I proposed [...] to start adopting ADRs to document decisions that were made. Thatd allow us to stop rehashing past conversations and allow people to onboard with fewer meetings.
… or so I think.
Because I think that ADRs could be an excellent way to scale this project up to A) many people, B) many timezones.</p>
</blockquote>
<p>I like this decision and have adopted and <a href="http://default/daily/2024/06/12/recording-architectural-decisions">written about ADRs before</a>.</p>
<p>I also like that the documents <a href="https://git.drupalcode.org/project/experience_builder/-/tree/0.x/docs/adr?ref_type=heads">are stored as markdown files in the repository</a>, alongside the code, making it easy for everyone to view or change.</p>
<p>As the work on Experience Builder continues, new contributors can read these documents and understand why previous decisions were made, which is extremely valuable.</p>
<p>I'm interested to see how ADRs work for the Experience Builder project and whether they're adopted more widely in other parts of the Drupal ecosystem.</p>
summary: null
field_daily_email_cta: { }