fix docs issues

docs/features/authorization.md

@@ -43,7 +43,7 @@ This feature also registers a custom `IAuthorizationMiddlewareResultHandler`
 and this handler directly throws;
 
 - `AuthenticationException` when challenged
-- `UnauthorizedAccessExcetpin` when forbidden
+- `UnauthorizedAccessException` when forbidden
 
 instead of using `IAuthenticationHandler` fallback methods.
 

docs/features/coding-style.md

@@ -103,7 +103,7 @@ c => c.RichEntity()
 
 Configures transient services as api services. This coding style allows you to
 have a public initializer (`With`) with parameters which will render as query
-parameters or single `id` parameter wich will render from route.
+parameters or single `id` parameter which will render from route.
 
 Rich transients with `id` types can be method parameters and located using
 their initializers.

docs/features/cors.md

@@ -15,7 +15,6 @@ This feature adds `AspNetCore` cors services and middleware.
 
 ```csharp
 c => c.AspNetCore([...])
-}
 ```
 
 ## Disabled
@@ -24,4 +23,4 @@ You can disable this feature by calling `Disabled()` method;
 
 ```csharp
 c => c.Disabled()
-```
+```

docs/features/database.md

@@ -25,6 +25,14 @@ Adds MySQL database setup which gets connection parameters from `app.settings`.
 c => c.MySql()
 ```
 
+## Oracle
+
+Adds Oracle database setup which gets connection parameters from `app.settings`.
+
+```csharp
+c => c.Oracle()
+```
+
 ## PostgreSQL
 
 Adds PostgreSQL database setup which gets connection parameters from

docs/layers/code-generation.md

@@ -8,7 +8,7 @@ app.Layers.AddCodeGeneration();
 
 ## Configuration Targets
 
-Code generation layer provides `IGeneratedAssemblyCollection`, 
+Code generation layer provides `IGeneratedAssemblyCollection`,
 `IGeneratedFileCollection` and `GeneratedContext` configuration targets.
 
 ### `IGeneratedAssemblyCollection`
@@ -33,29 +33,29 @@ configurator.ConfigureGeneratedFileCollection(files =>
 });
 ```
 
-### `GeneratedContext`
-
-This target is provided in `BuildConfiguration` phase and contains generated
-assemblies and files data. To configure it in a feature;
-
-```csharp
-configurator.ConfigureGeneratedFileCollection(files =>
-{
-    ...
-});
-```
-
 ## Phases
 
 This layer introduces following `Generate` phases to the application it is added;
 
 - `GenerateCode`: This phase creates a `IGeneratedAssemblyCollection` instance
   and places it in the application context
-- `Compile`: This phase compiles generated code during above phase, saves 
-  generated assemblies and files to entry assembly location with 
+- `Compile`: This phase compiles generated code during above phase, saves
+  generated assemblies and files to entry assembly location with
   `ASPNETCORE_ENVIRONMENT` subfolder
 
 > [!TIP]
 >
-> To access to a generated assembly from a feature use
-> `configurator.Context.GetGeneratedContext().Assemblies["MyAssembly"]` extension method.
+> To access to a generated assembly or file from a feature use below extension method;
+>
+> ```csharp
+> configurator.UsingGeneratedContext(generatedContext =>
+> {
+>     // generated assembly
+>     var assembly = generatedContext.Assemblies[...];
+>
+>     // generated file helpers
+>     var path = generatedContext.Files[...];
+>     var contentString = generatedContext.ReadFile(...);
+>     var data = generatedContext.ReadFileAsJson<...>();
+> });
+> ```

docs/layers/domain.md

@@ -11,10 +11,10 @@ app.Layers.AddDomain();
 ## Configuration Targets
 
 This layer provides `IDomainTypeCollection` and `DomainModelBuilderOptions`
-configuration targets for building `DomainModel` in `Generate` mode. It also 
+configuration targets for building `DomainModel` in `Generate` mode. It also
 provides `DomainServiceCollection` configuration target for features to add
 `DomainServiceDescriptor` for domain types which then be used to generate an
-`IServiceAdder` implementation. The generated `IServiceAdder` is then 
+`IServiceAdder` implementation. The generated `IServiceAdder` is then
 used in `Start` mode for auto registering domain types to service collection.
 
 ### `IDomainTypeCollection`
@@ -42,13 +42,14 @@ configurator.ConfigureDomainBuilderOptions(options =>
 
 ### `DomainServiceCollection`
 
-This target is provided in `GenerateCode` phase and it is used to generated 
-`IServiceAdder` to add domain services during `AddService` phase in `Start` 
+This target is provided in `GenerateCode` phase and it is used to generated
+`IServiceAdder` to add domain services during `AddService` phase in `Start`
 mode. To configure it in a feature;
 
 ```csharp
-configurator.ConfigureDomainServiceCollection(services =>
+configurator.ConfigureDomainServiceCollection((services, domain) =>
 {
+    // use domain metadata to register services at generate time
     ...
 });
 ```
@@ -61,3 +62,15 @@ This layer introduces following `Generate` phases to the application it is added
   application context
 - `BuildDomainModel`: This phase uses domain types to build and add a
   `DomainModel` instance to the application context
+
+> [!TIP]
+>
+> To access the domain model from a feature use below extension method;
+>
+> ```csharp
+> configurator.UsingDomainModel(domain =>
+> {
+>     // use domain metadata to configure any configuration target
+>     ...
+> });
+> ```

docs/recipes/data-source.md

@@ -65,7 +65,7 @@ Bake.New
 
 ```mermaid
 flowchart LR;
-    
+
     subgraph Generate
       AD(AddDomainTypes)
       BD(BuildDomainModel)
@@ -74,7 +74,7 @@ flowchart LR;
 
       AD -->|IDomainTypeCollection| BD
       BD -->|DomainModel| GC
-      GC -->|IGeneratedAssemblyCollection<br/>IGeneratedFileCollection<br/>DomainServiceCollection| C
+      GC -->|IGeneratedAssemblyCollection<br/>IGeneratedFileCollection| C
     end
 
     subgraph Start

docs/recipes/service.md

@@ -76,7 +76,7 @@ Bake.New
 
 ```mermaid
 flowchart LR;
-    
+
     subgraph Generate
       AD(AddDomainTypes)
       BD(BuildDomainModel)
@@ -85,7 +85,7 @@ flowchart LR;
 
       AD -->|IDomainTypeCollection| BD
       BD -->|DomainModel| GC
-      GC -->|IGeneratedAssemblyCollection<br/>IGeneratedFileCollection<br/>DomainServiceCollection| C
+      GC -->|IGeneratedAssemblyCollection<br/>IGeneratedFileCollection| C
     end
 
     subgraph Start
@@ -104,4 +104,4 @@ flowchart LR;
     end
 
     Generate --> Start
-```
+```