json-schema-org.github.io icon indicating copy to clipboard operation
json-schema-org.github.io copied to clipboard

Published 20 hours ago • verified publisher icon json-schema-org

Publish ADRs on the web site

Open handrews opened this issue 3 years ago • 1 comments

We should use our ADRs to communicate formal decisions to a broader audience than just those who look at GitHub. This should just point to main on the spec repo, no need for branching.

handrews avatar Sep 19 '22 15:09 handrews

I'm not sure the general public is generally the audience of ADRs. It might make more sense to release a blog post when we commit an ADR that concerns the general public and link to relevant ADRs for additional information. For example, when we decide on a post-IETF SDLC, it would make sense to write a blog post describing what's changing and how it will effect the general public. It would link to the decoupling from IETF ADR, an ADR about why we chose the SDLC we did, and a document defining our SDLC. Not being intended for general public consumption, I think these linked documents don't need to be on the website. We just need to be better about blogging about things when it makes sense.

jdesrosiers avatar Sep 21 '22 20:09 jdesrosiers

@jdesrosiers after recent events I agree with you, so I'm going to go ahead and close this.

handrews avatar Oct 27 '22 01:10 handrews