search

cedar-policy / rfcs

Apache License 2.0
10 stars 8 forks source link

Doc comments #63

Open john-h-kastner-aws opened 7 months ago

john-h-kastner-aws commented 7 months ago

Rendered

max2me commented 6 months ago

LGTM. I'm especially excited about support for doc comments in JSON policy format.

john-h-kastner-aws commented 4 months ago

We've tagged this as archived because we think that doc-comments should sugar for @doc annotations regardless of what the doc-comment syntax is. We plan to first extend where annotations can be placed (do be determined based on the outcome of rfc #48). After that documentation tooling can be developed against the annotation API. We can then re-examine this RFC to introduce syntactic sugar for doc comments.