Add documentation for new is operator

[john-h-kastner-aws]

Adding docs for is operator which will be released in the upcoming Cedar 3.0 release.

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[khieta]

Overall content looks good, although I'll leave the final approval to @AMZ-brandon.

Please also update docs/collections/_other/doc-history.md to reflect that the is operator corresponds to a new language version (2.2.0?).

[cdisselkoen]

to reflect that the is operator corresponds to a new language version (2.2.0?).

Cedar SDK 3.0 will also have to be language 3.0; although is is not a breaking change for the language, things like RFC 20 are.

[AMZ-brandon]

I'm putting together a preview in my test repo. This branch is behind main - can you update it from the base branch?

[john-h-kastner-aws]

updated

[AMZ-brandon]

Thanks for updating! I've pulled the branch - preview here.

I am updating the document history and adding syntax highlighting to is.

What should be the new language version for the doc history? 3.0? And what PR in the Cedar repo matches this update?

[john-h-kastner-aws]

What should be the new language version for the doc history? 3.0?

Yes. This will be released with version 3.0 (to be release soon).

And what PR in the Cedar repo matches this update?

is was added in cedar-policy/cedar#396 following to the design in rfc5

[AMZ-brandon]

Let me know if that doc history update looks accurate. Otherwise LGTM & will merge.

[john-h-kastner-aws]

We should wait on the merge until the 3.0 release happens so we don't have is referenced in the docs before the new version is on crates.io. That will be a week or two probably.

[AMZ-brandon]

Got it, standing by until I hear of the release.