Merge pull request #111 from cedar-policy/khieta/cedar-lang-version

update cedar lang versions

docs/collections/_other/doc-history.md

@@ -7,28 +7,29 @@ nav_order: 14
 # History for the Cedar Policy Language {#doc-history}
 {: .no_toc }
 
-## Document history for the Cedar Policy Language Guide 
+## Document history for the Cedar Policy Language Guide
 The following table describes major documentation updates for Cedar.
 
 | Description | Date |
 | --- | --- |
+| Added [Human-readable schema format](../schema/human-readable-schema.html) topic | February 21, 2024 |
 | Added [`is` operator](../policies/syntax-operators.html) | December 15, 2023 |
 | Added [Entities & context syntax](../auth/entities-syntax.html) topic | July 27, 2023 |
 | Added [Schema grammar](../schema/schema-grammar.html) topic | July 17, 2023 |
 | Added [JSON policy format](../policies/json-format.html) reference page | July 14, 2023 |
 | Added [Best Practices](../overview/best-practices.html) topics | July 14, 2023 |
-| Initial release of the Cedar Policy Language Guide | May 10, 2023 | 
-
+| Initial release of the Cedar Policy Language Guide | May 10, 2023 |
 
 ## History of the Cedar language
 
-| Cedar<br/>Version | Description | Cedar SDK<br/>Versions | Date | 
-| --- |--- |--- | --- |
-| 3.0.0 | New `is` operator [PR](https://github.com/cedar-policy/cedar/pull/396) | 3.0.0 | December 15, 2023 |
-| 2.1.2 | Change to how validation treats template-linked policies [PR](https://github.com/cedar-policy/cedar/pull/371) | 2.4.2 | October 23, 2023 |
-| 2.1.1 | Increased validation precision [PR](https://github.com/cedar-policy/cedar/pull/117) | 2.4.0 - 2.4.1 | September 29, 2023 |
-| 2.1.0 | [RFC #9](https://github.com/cedar-policy/rfcs/blob/main/text/0009-disallow-whitespace-in-entityuid.md): Disallows whitespace in namespaces | 2.3.0 - 2.3.3 | June 29, 2023 |
-| 2.0.0 | Initial release of the Cedar Policy Language | 2.0.0 - 2.2.0 | May 10, 2023 |
-
-
-
+The following table tracks changes to the Cedar language version. The language version is different from the SDK version (which corresponds to the `cedar-policy` version on [crates.io](https://crates.io/crates/cedar-policy)) because a breaking change for the Cedar Rust API may or may not be a breaking change for the Cedar language. See the [SDK changelog](https://github.com/cedar-policy/cedar/blob/main/cedar-policy/CHANGELOG.md) for details about what is included in different SDK versions. We recommend using the latest SDK version that supports your desired language version since later SDK versions may contain important bug fixes and improvements to usability.
+
+| Cedar<br/>Version | Description | Cedar SDK<br/>Version(s) | Date |
+| --- | --- | --- | --- |
+| 3.3 | References between common types [cedar#154](https://github.com/cedar-policy/cedar/issues/154) | 3.2.0 - 3.2.1 | May 17, 2024 |
+| 3.2 | General multiplication operator [rfc#57](https://github.com/cedar-policy/rfcs/blob/main/text/0057-general-multiplication.md) | 3.1.2 - 3.1.4 | March 29, 2024 |
+| 3.1 | Human-readable schema syntax [rfc#24](https://github.com/cedar-policy/rfcs/blob/main/text/0024-schema-syntax.md) | 3.1.0 - 3.1.1 | March 8, 2024 |
+| 3.0 | `is` operator [rfc#5](https://github.com/cedar-policy/rfcs/blob/main/text/0005-is-operator.md)<br/>Stricter validation [rfc#19](https://github.com/cedar-policy/rfcs/blob/main/text/0019-stricter-validation.md)<br/>Disallow duplicate keys in records [rfc#20](https://github.com/cedar-policy/rfcs/blob/main/text/0020-unique-record-keys.md)<br/>Request validation [cedar#191](https://github.com/cedar-policy/cedar/issues/191)<br/>Entity validation [cedar#360](https://github.com/cedar-policy/cedar/pull/360) | 3.0.0 - 3.0.1 | December 15, 2023 |
+| 2.2 | General multiplication operator (backport to 2.x) [rfc#57](https://github.com/cedar-policy/rfcs/blob/main/text/0057-general-multiplication.md) | 2.4.5 - 2.4.7 | April 1, 2024 |
+| 2.1 | Disallow whitespace in namespaces [rfc#9](https://github.com/cedar-policy/rfcs/blob/main/text/0009-disallow-whitespace-in-entityuid.md) | 2.3.0 - 2.4.4 | June 29, 2023 |
+| 2.0 | Initial release of the Cedar Policy Language | 2.0.0 - 2.2.0 | May 10, 2023 |

docs/index.md

@@ -7,7 +7,7 @@ nav_order: 2
 # Welcome to the Cedar policy language {#welcome-to-cedar}
 {: .no_toc }
 
-This guide is a reference for [Version 3.0](other/doc-history.html) of the Cedar policy language.
+This guide is a reference for [Version 3.3](other/doc-history.html) of the Cedar policy language.
 
 Cedar is a language for writing authorization policies and making authorization decisions based on those policies. When you create an application, you need to ensure that only authorized users can access the application, and can do only what each user is authorized to do.