diff --git a/source/_daily_emails/2024-09-21.md b/source/_daily_emails/2024-09-21.md new file mode 100644 index 00000000..3be0088a --- /dev/null +++ b/source/_daily_emails/2024-09-21.md @@ -0,0 +1,33 @@ +--- +title: Drupal adopts ADRs +date: 2024-09-21 +permalink: daily/2024/09/21/drupal-adopts-adrs +tags: + - software-development + - drupal + - php +cta: ~ +snippet: | + Drupal's Experience Builder project adopts ADRs. +drupal_planet: true +--- + +Today I noticed that Drupal's Experience Builder project [has adopted architectural decision records][0]. + +From the issue: + +> I proposed [...] to start adopting ADRs to document decisions that were made. That’d 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. + +I like this decision and have adopted and [written about ADRs before][1]. + +I also like that the documents [are stored as markdown files in the repository][2], alongside the code, making it easy for everyone to view or change. + +As the work on Experience Builder continues, new contributors can read these documents and understand why previous decisions were made, which is extremely valuable. + +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. + +[0]: https://www.drupal.org/project/experience_builder/issues/3454669 +[1]: {{site.url}}/daily/2024/06/12/recording-architectural-decisions +[2]: https://git.drupalcode.org/project/experience_builder/-/tree/0.x/docs/adr?ref_type=heads