spruce up the repo's readme (#21)

README.md

@@ -1,8 +1,19 @@
-# orgs
+# clerk/orgs
 
 A set of examples using [Clerk's](https://clerk.com) Organizations functionality
 
-### Example Projects
+[Orgs](https://clerk.com/docs/organizations/overview) are a flexible way to manage users and their access to resources within your Clerk application. With organizations, you can assign specific roles and permissions to users, making them useful for managing projects, coordinating teams, or facilitating partnerships.
+
+And when you model your B2B Application's customers as Orgs, you can begin to customize their experience in meaningful ways with:
+
+- Roles and Permissions
+- Verified Domains and Enrollment Modes
+- Invitations
+- Easy context shifting in your app via the `<OrgSwitcher />` component
+- Organization Metadata
+- Customizable Enterprise-grade SSO for each of your customers
+
+### Examples
 
 - [Organization Creation Limitations](examples/limit-org-creation/)
 - [Force an Organization](examples/force-an-org/)