json-schema-org/json-schema-org.github.io

Publish ADRs on the web site

handrews opened this issue · 2 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.

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 after recent events I agree with you, so I'm going to go ahead and close this.