Update generated documentation for version 1.4.4

Author: Thorium

core/composable.html

@@ -462,8 +462,8 @@ <h2><a name="Generate-composable-queries-from-quotations" class="anchor" href="#
 <div class="fsdocs-tip" id="fs20">val query1: IQueryable&lt;SqlDataProvider&lt;...&gt;.dataContext.main.CustomersEntity&gt;</div>
 <div class="fsdocs-tip" id="fs21">val query: Linq.QueryBuilder</div>
 <div class="fsdocs-tip" id="fs22">val customers: SqlDataProvider&lt;...&gt;.dataContext.main.CustomersEntity</div>
-<div class="fsdocs-tip" id="fs23">property SqlDataProvider&lt;...&gt;.dataContext.Main: SqlDataProvider&lt;...&gt;.dataContext.mainSchema with get</div>
-<div class="fsdocs-tip" id="fs24">property SqlDataProvider&lt;...&gt;.dataContext.mainSchema.Customers: SqlDataProvider&lt;...&gt;.dataContext.mainSchema.main.Customers with get<br /><em>&lt;summary&gt;  The table Customers belonging to schema main&lt;/summary&gt;</em></div>
+<div class="fsdocs-tip" id="fs23">property SqlDataProvider&lt;...&gt;.dataContext.Main: SqlDataProvider&lt;...&gt;.readDataContext.mainSchema with get</div>
+<div class="fsdocs-tip" id="fs24">property SqlDataProvider&lt;...&gt;.readDataContext.mainSchema.Customers: SqlDataProvider&lt;...&gt;.readDataContext.mainSchema.main.Customers with get<br /><em>&lt;summary&gt;  The table Customers belonging to schema main&lt;/summary&gt;</em></div>
 <div class="fsdocs-tip" id="fs25">custom operation: where (bool)
 
 Calls Linq.QueryBuilder.Where</div>
@@ -492,6 +492,7 @@ <h2><a name="Generate-composable-queries-from-quotations" class="anchor" href="#
 <div class="fsdocs-tip" id="fs35">val x: obj</div>
 <div class="fsdocs-tip" id="fs36">type CustomersEntity = SqlDataProvider&lt;...&gt;.dataContext.main.CustomersEntity</div>
 <div class="fsdocs-tip" id="fs37">type dataContext =
+  member AsReadOnly: unit -&gt; readDataContext
   member ClearUpdates: unit -&gt; List&lt;SqlEntity&gt;
   member CreateConnection: unit -&gt; IDbConnection
   member GetUpdates: unit -&gt; List&lt;SqlEntity&gt;
@@ -501,8 +502,7 @@ <h2><a name="Generate-composable-queries-from-quotations" class="anchor" href="#
   member ``Design Time Commands`` : DesignTimeCommands
   member Main: mainSchema
   member Pragma: Pragma
-  nested type DesignTimeCommands
-  ...</div>
+  ...<br /><em>Use dataContext to explore database schema and querying data. It will carry database-connection and possible modifications within transaction, that you can commit via SubmitUpdates.</em></div>
 <div class="fsdocs-tip" id="fs38">val companyNameFilter: inUse: bool -&gt; (IQueryable&lt;CustomersEntity&gt; -&gt; IQueryable&lt;CustomersEntity&gt;)</div>
 <div class="fsdocs-tip" id="fs39">val inUse: bool</div>
 <div class="fsdocs-tip" id="fs40">val myFilter2: x: IQueryable&lt;CustomersEntity&gt; -&gt; IQueryable&lt;CustomersEntity&gt;</div>
@@ -542,7 +542,7 @@ <h2><a name="Generate-composable-queries-from-quotations" class="anchor" href="#
 <div class="fsdocs-tip" id="fs72">val runtimeSelectedFilter: Quotations.Expr&lt;(SqlDataProvider&lt;...&gt;.dataContext.main.EmployeesEntity -&gt; bool)&gt;</div>
 <div class="fsdocs-tip" id="fs73">val employees: SqlDataProvider&lt;...&gt;.dataContext.main.EmployeesEntity array</div>
 <div class="fsdocs-tip" id="fs74">val emp: SqlDataProvider&lt;...&gt;.dataContext.main.EmployeesEntity</div>
-<div class="fsdocs-tip" id="fs75">property SqlDataProvider&lt;...&gt;.dataContext.mainSchema.Employees: SqlDataProvider&lt;...&gt;.dataContext.mainSchema.main.Employees with get<br /><em>&lt;summary&gt;  The table Employees belonging to schema main&lt;/summary&gt;</em></div>
+<div class="fsdocs-tip" id="fs75">property SqlDataProvider&lt;...&gt;.readDataContext.mainSchema.Employees: SqlDataProvider&lt;...&gt;.readDataContext.mainSchema.main.Employees with get<br /><em>&lt;summary&gt;  The table Employees belonging to schema main&lt;/summary&gt;</em></div>
 
     </div>
 </main>

core/crud.html

@@ -519,12 +519,12 @@ <h3><a name="What-to-do-if-your-creation-fails-systematically-every-time" class=
 <div class="fsdocs-tip" id="fs17">val ctx: SqlDataProvider&lt;...&gt;.dataContext</div>
 <div class="fsdocs-tip" id="fs18">SqlDataProvider&lt;...&gt;.GetDataContext() : SqlDataProvider&lt;...&gt;.dataContext<br /><em>&lt;summary&gt;Returns an instance of the SQL Provider using the static parameters&lt;/summary&gt;</em><br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />SqlDataProvider&lt;...&gt;.GetDataContext(selectOperations: SelectOperations) : SqlDataProvider&lt;...&gt;.dataContext<br /><em>&lt;summary&gt;Returns an instance of the SQL Provider using the static parameters&lt;/summary&gt;&lt;param name=&#39;selectOperations&#39;&gt;Execute select-clause operations in SQL database rather than .NET-side.&lt;/param&gt;</em><br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />SqlDataProvider&lt;...&gt;.GetDataContext(commandTimeout: int) : SqlDataProvider&lt;...&gt;.dataContext<br /><em>&lt;summary&gt;Returns an instance of the SQL Provider using the static parameters&lt;/summary&gt;&lt;param name=&#39;commandTimeout&#39;&gt;SQL command timeout. Maximum time for single SQL-command in seconds.&lt;/param&gt;</em><br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />SqlDataProvider&lt;...&gt;.GetDataContext(transactionOptions: Transactions.TransactionOptions) : SqlDataProvider&lt;...&gt;.dataContext<br /><em>&lt;summary&gt;Returns an instance of the SQL Provider using the static parameters&lt;/summary&gt;&lt;param name=&#39;transactionOptions&#39;&gt;TransactionOptions for the transaction created on SubmitChanges.&lt;/param&gt;</em><br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />SqlDataProvider&lt;...&gt;.GetDataContext(connectionString: string) : SqlDataProvider&lt;...&gt;.dataContext<br /><em>&lt;summary&gt;Returns an instance of the SQL Provider using the static parameters&lt;/summary&gt;&lt;param name=&#39;connectionString&#39;&gt;The database runtime connection string&lt;/param&gt;</em><br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />SqlDataProvider&lt;...&gt;.GetDataContext(connectionString: string, selectOperations: SelectOperations) : SqlDataProvider&lt;...&gt;.dataContext<br /><em>&lt;summary&gt;Returns an instance of the SQL Provider using the static parameters&lt;/summary&gt;&lt;param name=&#39;connectionString&#39;&gt;The database runtime connection string&lt;/param&gt;&lt;param name=&#39;selectOperations&#39;&gt;Execute select-clause operations in SQL database rather than .NET-side.&lt;/param&gt;</em><br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />SqlDataProvider&lt;...&gt;.GetDataContext(transactionOptions: Transactions.TransactionOptions, commandTimeout: int) : SqlDataProvider&lt;...&gt;.dataContext<br /><em>&lt;summary&gt;Returns an instance of the SQL Provider using the static parameters&lt;/summary&gt;&lt;param name=&#39;transactionOptions&#39;&gt;TransactionOptions for the transaction created on SubmitChanges.&lt;/param&gt;&lt;param name=&#39;commandTimeout&#39;&gt;SQL command timeout. Maximum time for single SQL-command in seconds.&lt;/param&gt;</em><br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />SqlDataProvider&lt;...&gt;.GetDataContext(connectionString: string, commandTimeout: int) : SqlDataProvider&lt;...&gt;.dataContext<br /><em>&lt;summary&gt;Returns an instance of the SQL Provider using the static parameters&lt;/summary&gt;&lt;param name=&#39;connectionString&#39;&gt;The database runtime connection string&lt;/param&gt;&lt;param name=&#39;commandTimeout&#39;&gt;SQL command timeout. Maximum time for single SQL-command in seconds.&lt;/param&gt;</em><br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />SqlDataProvider&lt;...&gt;.GetDataContext(connectionString: string, transactionOptions: Transactions.TransactionOptions) : SqlDataProvider&lt;...&gt;.dataContext<br /><em>&lt;summary&gt;Returns an instance of the SQL Provider using the static parameters&lt;/summary&gt;&lt;param name=&#39;connectionString&#39;&gt;The database runtime connection string&lt;/param&gt;&lt;param name=&#39;transactionOptions&#39;&gt;TransactionOptions for the transaction created on SubmitChanges.&lt;/param&gt;</em><br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />SqlDataProvider&lt;...&gt;.GetDataContext(connectionString: string, resolutionPath: string) : SqlDataProvider&lt;...&gt;.dataContext<br /><em>&lt;summary&gt;Returns an instance of the SQL Provider using the static parameters&lt;/summary&gt;&lt;param name=&#39;connectionString&#39;&gt;The database runtime connection string&lt;/param&gt;&lt;param name=&#39;resolutionPath&#39;&gt;The location to look for dynamically loaded assemblies containing database vendor specific connections and custom types.  Types used in desing-time: If no better clue, prefer .NET Standard 2.0 versions. Semicolon to separate multiple.&lt;/param&gt;</em><br />&#160;&#160;&#160;<em>(+0 other overloads)</em></div>
 <div class="fsdocs-tip" id="fs19">val orders: SqlDataProvider&lt;...&gt;.dataContext.mainSchema.main.Orders</div>
-<div class="fsdocs-tip" id="fs20">property SqlDataProvider&lt;...&gt;.dataContext.Main: SqlDataProvider&lt;...&gt;.dataContext.mainSchema with get</div>
-<div class="fsdocs-tip" id="fs21">property SqlDataProvider&lt;...&gt;.dataContext.mainSchema.Orders: SqlDataProvider&lt;...&gt;.dataContext.mainSchema.main.Orders with get<br /><em>&lt;summary&gt;  The table Orders belonging to schema main&lt;/summary&gt;</em></div>
+<div class="fsdocs-tip" id="fs20">property SqlDataProvider&lt;...&gt;.dataContext.Main: SqlDataProvider&lt;...&gt;.readDataContext.mainSchema with get</div>
+<div class="fsdocs-tip" id="fs21">property SqlDataProvider&lt;...&gt;.readDataContext.mainSchema.Orders: SqlDataProvider&lt;...&gt;.readDataContext.mainSchema.main.Orders with get<br /><em>&lt;summary&gt;  The table Orders belonging to schema main&lt;/summary&gt;</em></div>
 <div class="fsdocs-tip" id="fs22">val employees: SqlDataProvider&lt;...&gt;.dataContext.mainSchema.main.Employees</div>
-<div class="fsdocs-tip" id="fs23">property SqlDataProvider&lt;...&gt;.dataContext.mainSchema.Employees: SqlDataProvider&lt;...&gt;.dataContext.mainSchema.main.Employees with get<br /><em>&lt;summary&gt;  The table Employees belonging to schema main&lt;/summary&gt;</em></div>
+<div class="fsdocs-tip" id="fs23">property SqlDataProvider&lt;...&gt;.readDataContext.mainSchema.Employees: SqlDataProvider&lt;...&gt;.readDataContext.mainSchema.main.Employees with get<br /><em>&lt;summary&gt;  The table Employees belonging to schema main&lt;/summary&gt;</em></div>
 <div class="fsdocs-tip" id="fs24">val customer: SqlDataProvider&lt;...&gt;.dataContext.main.CustomersEntity</div>
-<div class="fsdocs-tip" id="fs25">property SqlDataProvider&lt;...&gt;.dataContext.mainSchema.Customers: SqlDataProvider&lt;...&gt;.dataContext.mainSchema.main.Customers with get<br /><em>&lt;summary&gt;  The table Customers belonging to schema main&lt;/summary&gt;</em></div>
+<div class="fsdocs-tip" id="fs25">property SqlDataProvider&lt;...&gt;.readDataContext.mainSchema.Customers: SqlDataProvider&lt;...&gt;.readDataContext.mainSchema.main.Customers with get<br /><em>&lt;summary&gt;  The table Customers belonging to schema main&lt;/summary&gt;</em></div>
 <div class="fsdocs-tip" id="fs26">Multiple items<br />module Seq
 
 from FSharp.Data.Sql<br /><br />--------------------<br />module Seq
@@ -548,7 +548,7 @@ <h3><a name="What-to-do-if-your-creation-fails-systematically-every-time" class=
   ...<br /><em>&lt;summary&gt;Represents an instant in time, typically expressed as a date and time of day.&lt;/summary&gt;</em><br /><br />--------------------<br />DateTime ()<br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />DateTime(ticks: int64) : DateTime<br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />DateTime(date: DateOnly, time: TimeOnly) : DateTime<br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />DateTime(ticks: int64, kind: DateTimeKind) : DateTime<br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />DateTime(date: DateOnly, time: TimeOnly, kind: DateTimeKind) : DateTime<br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />DateTime(year: int, month: int, day: int) : DateTime<br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />DateTime(year: int, month: int, day: int, calendar: Globalization.Calendar) : DateTime<br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />DateTime(year: int, month: int, day: int, hour: int, minute: int, second: int) : DateTime<br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />DateTime(year: int, month: int, day: int, hour: int, minute: int, second: int, kind: DateTimeKind) : DateTime<br />&#160;&#160;&#160;<em>(+0 other overloads)</em><br />DateTime(year: int, month: int, day: int, hour: int, minute: int, second: int, calendar: Globalization.Calendar) : DateTime<br />&#160;&#160;&#160;<em>(+0 other overloads)</em></div>
 <div class="fsdocs-tip" id="fs31">property DateTime.Now: DateTime with get<br /><em>&lt;summary&gt;Gets a &lt;see cref=&quot;T:System.DateTime&quot; /&gt; object that is set to the current date and time on this computer, expressed as the local time.&lt;/summary&gt;<br />&lt;returns&gt;An object whose value is the current local date and time.&lt;/returns&gt;</em></div>
 <div class="fsdocs-tip" id="fs32">val row: SqlDataProvider&lt;...&gt;.dataContext.main.OrdersEntity</div>
-<div class="fsdocs-tip" id="fs33">SqlDataProvider&lt;...&gt;.dataContext.mainSchema.main.Orders.Create() : SqlDataProvider&lt;...&gt;.dataContext.main.OrdersEntity<br />SqlDataProvider&lt;...&gt;.dataContext.mainSchema.main.Orders.Create(data: Collections.Generic.IEnumerable&lt;string * obj&gt;) : SqlDataProvider&lt;...&gt;.dataContext.main.OrdersEntity<br /><em>&lt;summary&gt;Item array of database columns: 
+<div class="fsdocs-tip" id="fs33">SqlDataProvider&lt;...&gt;.readDataContext.mainSchema.main.Orders.Create() : SqlDataProvider&lt;...&gt;.dataContext.main.OrdersEntity<br />SqlDataProvider&lt;...&gt;.readDataContext.mainSchema.main.Orders.Create(data: Collections.Generic.IEnumerable&lt;string * obj&gt;) : SqlDataProvider&lt;...&gt;.dataContext.main.OrdersEntity<br /><em>&lt;summary&gt;Item array of database columns: 
 &lt;/summary&gt;</em></div>
 <div class="fsdocs-tip" id="fs34">property SqlDataProvider&lt;...&gt;.dataContext.main.OrdersEntity.CustomerId: string with get, set<br /><em>&lt;summary&gt;CustomerID:   nchar(5)&lt;/summary&gt;</em></div>
 <div class="fsdocs-tip" id="fs35">property SqlDataProvider&lt;...&gt;.dataContext.main.CustomersEntity.CustomerId: string with get, set<br /><em>&lt;summary&gt;CustomerID:   nchar(5)&lt;/summary&gt;</em></div>
@@ -595,8 +595,8 @@ <h3><a name="What-to-do-if-your-creation-fails-systematically-every-time" class=
 <div class="fsdocs-tip" id="fs55">val map: mapping: (&#39;T -&gt; &#39;U) -&gt; list: &#39;T list -&gt; &#39;U list</div>
 <div class="fsdocs-tip" id="fs56">val x: Employee</div>
 <div class="fsdocs-tip" id="fs57">val row: SqlDataProvider&lt;...&gt;.dataContext.main.EmployeesEntity</div>
-<div class="fsdocs-tip" id="fs58">SqlDataProvider&lt;...&gt;.dataContext.mainSchema.main.Employees.Create() : SqlDataProvider&lt;...&gt;.dataContext.main.EmployeesEntity<br />SqlDataProvider&lt;...&gt;.dataContext.mainSchema.main.Employees.Create(data: Collections.Generic.IEnumerable&lt;string * obj&gt;) : SqlDataProvider&lt;...&gt;.dataContext.main.EmployeesEntity<br /><em>&lt;summary&gt;Item array of database columns: 
-FirstName,LastName&lt;/summary&gt;</em><br />SqlDataProvider&lt;...&gt;.dataContext.mainSchema.main.Employees.Create(FirstName: string, LastName: string) : SqlDataProvider&lt;...&gt;.dataContext.main.EmployeesEntity</div>
+<div class="fsdocs-tip" id="fs58">SqlDataProvider&lt;...&gt;.readDataContext.mainSchema.main.Employees.Create() : SqlDataProvider&lt;...&gt;.dataContext.main.EmployeesEntity<br />SqlDataProvider&lt;...&gt;.readDataContext.mainSchema.main.Employees.Create(data: Collections.Generic.IEnumerable&lt;string * obj&gt;) : SqlDataProvider&lt;...&gt;.dataContext.main.EmployeesEntity<br /><em>&lt;summary&gt;Item array of database columns: 
+FirstName,LastName&lt;/summary&gt;</em><br />SqlDataProvider&lt;...&gt;.readDataContext.mainSchema.main.Employees.Create(FirstName: string, LastName: string) : SqlDataProvider&lt;...&gt;.dataContext.main.EmployeesEntity</div>
 <div class="fsdocs-tip" id="fs59">property SqlDataProvider&lt;...&gt;.dataContext.main.EmployeesEntity.FirstName: string with get, set<br /><em>&lt;summary&gt;FirstName:   nvarchar(10)&lt;/summary&gt;</em></div>
 <div class="fsdocs-tip" id="fs60">Employee.FirstName: string</div>
 <div class="fsdocs-tip" id="fs61">property SqlDataProvider&lt;...&gt;.dataContext.main.EmployeesEntity.LastName: string with get, set<br /><em>&lt;summary&gt;LastName:   nvarchar(20)&lt;/summary&gt;</em></div>