docs: Revise documentation section in README.md (#18)

* docs: Revise documentation section in README.md

The pulling the example implementation up in the README because that's what people need.

* Update README.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: mvhenten

README.md

@@ -10,67 +10,6 @@ Install this generator in your typespec project:
 
 Then, annotate your models using `@entity`, `@index`, `@createdAt`, `@updatedAt`, `@label`
 
-## Documentation
-
-See [./tsp/main.tsp](/tsp/main.tsp) for the type definitions of the annotations. 
-
-```typespec
-
-/**
- * Generates a DynamoDB entity definition for this model.
- */
-extern dec entity(
-    target: Model,
-    entity: string,
-    service: string,
-    version?: int32
-);
-
-/**
- * Adds the ElectroDB "label" property to the attribute definition.
- * See https://electrodb.dev/en/modeling/attributes/#label
- */
-extern dec label(target: ModelProperty, label: string);
-
-/**
- * Define a "createdAt" timestamp. See https://electrodb.dev/en/recipes/created-at-updated-at/
- */
-extern dec createdAt(target: ModelProperty, label?: string);
-
-/**
- * Define a "updatedAt" timestamp. See https://electrodb.dev/en/recipes/created-at-updated-at/
- */
-extern dec updatedAt(target: ModelProperty, label?: string);
-
-/**
- * Define an ElectroDB index. See https://electrodb.dev/en/modeling/indexes/
- *
- * Use either shorthand definition:
- *
- * `@index("persons", { pk: [Persons.pk] })`
- *
- * Or full access pattern:
- *
- 
-  model AccessPattern {
-     index?: string;
-     collection?: string | string[];
-     type?: IndexType = IndexType.isolated;
-     pk?: ModelProperty[] | {
-         field?: string = "pk";
-         composite: ModelProperty[];
-     };
-     sk?: ModelProperty[] | {
-         field?: string = "sk";
-         composite: ModelProperty[] = #[];
-     };
- }
- *
- */
-extern dec index(target: Model, name: string, accessPattern: AccessPattern);
-
-```
-
 ## Example
 
 Take a peek at the [./demo/main.tsp](./demo/main.tsp) for an of how this works:
@@ -279,5 +218,10 @@ export declare const Person: {
         readonly version: "1";
     };
 };
-
 ```
+
+## Documentation
+
+This extension itself is driven by TypeSpec type definitions, mostly pieced together by reading existing (REST) extensions and https://typespec.io/docs/extending-typespec/create-decorators/
+
+See [./tsp/main.tsp](/tsp/main.tsp) for the type definitions of the annotations.