chore: added fgn and adjusted list users announcement (#754)

Co-authored-by: Raghd Hamzeh <[email protected]>

blog/fine-grained-news-2024-05.md

@@ -0,0 +1,57 @@
+---
+title: Fine Grained News - May 2024
+description: Fine Grained News
+slug: fine-grained-news-2024-05
+date: 2024-05-30
+authors: aaguiar
+tags: [newsletter]
+image: https://openfga.dev/img/og-rich-embed.png
+hide_table_of_contents: false
+---
+# Fine Grained News
+
+Welcome to Fine Grained News, May edition!
+
+## New Releases!
+
+- We shipped the [a ListUsers API](https://openfga.dev/blog/list-users-announcement). ListUsers allows you to retrieve all the users that have a specific relation with a resource (e.g. all users that can view a document).
+
+- In collaboration with [Yann D'Isanto](https://github.com/yann-disanto) we shipped a [plugin for JetBrain's IDEs](https://plugins.jetbrains.com/plugin/24394-openfga) to allow syntax coloring and validation of OpenFGA models. Together with the [Visual Studio Code integration](https://marketplace.visualstudio.com/items?itemName=openfga.openfga-vscode) and the [Tree sitter grammar](https://github.com/matoous/tree-sitter-fga) from [Matouš Dzivjak](https://github.com/matoous/), OpenFGA has get great coverage for major IDEs and editors.
+
+## What's Next
+
+- We've identified a few areas where we can improve performance and we are actively working on them.
+- We'll be [instrumenting our SDKs](https://github.com/openfga/roadmap/issues/41) to provide metrics / tracing and logging through OpenTelemetry APIs.
+- We'll be adding [additional consistency options](https://github.com/openfga/roadmap/issues/54) for OpenFGA query APIs.
+- We'll be working on adding [authorization for OpenFGA APIs](https://github.com/openfga/roadmap/issues/30).
+
+Please check the items above and let us know if you have any feedback or idea.
+
+## OpenFGA @ CloudNative SecurityCon
+
+OpenFGA will be present in [CloudNative SecurityCon North America](https://events.linuxfoundation.org/cloudnativesecuritycon-north-america/)! 
+
+[Maria Ines Parnisari](https://github.com/miparnisari) from the OpenFGA team and [Evan Anderson](https://github.com/evankanderson) from [Stacklok](https://stacklok.com/) will be presenting on [Implementing a Multi-Tenant, Relationship-Based Authorization Model with OpenFGA](
+https://cloudnativesecurityconna24.sched.com/event/1dCVn/implementing-a-multi-tenant-relationship-based-authorization-model-with-openfga-evan-anderson-stacklok-maria-ines-parnisari-okta). 
+
+We hope to see you there!
+
+## Latest Features
+
+In case you missed them, here are some of the latest major features we've added to OpenFGA:
+
+- [Conditional Tuples](https://openfga.dev/blog/conditional-tuples-announcement) allows you to define tuples that are only valid under certain conditions.
+- [Modular Models](https://openfga.dev/blog/modular-models-announcement) makes it easy for multiple teams to collaborate on a single OpenFGA model.
+- [List Users API](https://openfga.dev/blog/list-users-announcement) allowing you to retrieve all the users that have a specific relation with a resource.
+- [Spring Boot Starter for OpenFGA](https://github.com/openfga/spring-boot-starter) simplifies integrating OpenFGA with Spring Security applications.
+- [JetBrain's IDEs plugin](https://plugins.jetbrains.com/plugin/24394-openfga) to allow syntax coloring and validation of OpenFGA models.
+
+## Transitioning from Discord to CNCF's Slack
+
+As we mentioned before, we transitioned out from Discord for OpenFGA and are now using the CNCF [#openfga Slack channel](https://cloud-native.slack.com/archives/C06G1NNH47N). If you are not part of the CNCF Slack workspace, you need to join the [CNCF Slack](https://slack.cncf.io) first.
+
+Checkout https://openfga.dev/community for all the places to find us.
+
+## See you next month!
+
+Fine Grained News are published every month. If you have any feedback, want to share your OpenFGA story, or know about something that you think is worth mentioning, please let us know!

blog/list-users-announcement.md

@@ -2,7 +2,7 @@
 title: List Users API
 description: List Users API 
 slug: list-users-announcement
-date: 2024-04-30
+date: 2024-05-30
 authors: miparnisari
 tags: [openfga,features]
 image: https://openfga.dev/img/og-rich-embed.png
@@ -14,29 +14,21 @@ Today we are launching a new API for OpenFGA: ListUsers.
 
 This API will answer the question "what users have relation X with object Y?". This will be useful, for example, in UIs that want to display the list of users that a resource has been shared with, e.g. the "share" dialog in Google Docs.
 
-You can read more about this API [here](https://openfga.dev/api/service#/Relationship%20Queries/ListUsers).
+You can read more about it in the [API docs](https://openfga.dev/api/service#/Relationship%20Queries/ListUsers) and the [product documentation](https://openfga.dev/docs/getting-started/perform-list-users).
 
 ## How to use it?
 
-ListUsers is available in the latest Release Candidate version of OpenFGA: [v1.5.4-rc1](https://github.com/openfga/openfga/releases/tag/v1.5.4-rc1).
+ListUsers is available in OpenFGA starting with [v1.5.4](https://github.com/openfga/openfga/releases/tag/v1.5.4).
 
 To be able to call this API, you must turn on this flag on the server: `--experimentals enable-list-users`. Be sure to also check out the various configuration flags that were added to control its behavior.
 
-You can also call this API via the SDKs:
-- [Java v0.4.2](https://github.com/openfga/java-sdk/releases/tag/v0.4.2)
-- [.NET v0.3.2](https://github.com/openfga/dotnet-sdk/releases/tag/v0.3.2)
-- [Go v0.3.6](https://github.com/openfga/go-sdk/releases/tag/v0.3.6)
-- [Javascript v0.4.0](https://github.com/openfga/js-sdk/releases/tag/v0.4.0)
+The new functionality is available on the latest versions of the [Java](https://github.com/openfga/java-sdk/), [.NET](https://github.com/openfga/dotnet-sdk/), [Go](https://github.com/openfga/go-sdk/) and [Javascript SDK](https://github.com/openfga/js-sdk/), [CLI](https://github.com/openfga/cli?tab=readme-ov-file#list-users) and [VS Code integration](https://marketplace.visualstudio.com/items?itemName=openfga.openfga-vscode). 
 
-## What's next?
+We'll be releasing support for the Python SDK soon.
 
-Our next steps look as follows:
+## What's next?
 
-1. Release candidate with experimental flag (now)
-2. Any bug fixes
-3. Stable release with experimental flag
-4. Any performance improvements
-5. Stable release without experimental flag
+We have a [limitation](https://openfga.dev/docs/getting-started/perform-list-users#exclusion-of-nested-usersets) we are working on regarding the behavior of the `excluded_users` return value that we'll address before removing the experimental flag.
 
 ## We want your feedback!