openid / authzen

Proposed standard for an Authorization API
41 stars 12 forks source link

Unclear how to contribute to spec API repo #151

Open jogu opened 2 months ago

jogu commented 2 months ago

https://github.com/openid/authzen/tree/main/api contains a weird assortment of files to the point that when I was thinking to make a PR to fix one of the issues I was I got highly confused as to which file should be changed.

You could clarify in README.md maybe, but I suspect some files are no longer needed and should be deleted, e.g. authorization-api-1_0-original.md and authorization-api-1_0_00.md.

In other works groups I'd have expect authorization-api-1_0_01.md to have been named authorization-api-1_0.md and for the 00 revision to have just been viewable in an older tagged git commit to that file but maybe AuthZen has a deliberately different policy.