Fix documentation

Author: groue

GRDB/Core/Database.swift

@@ -878,13 +878,15 @@ public final class Database: CustomStringConvertible, CustomDebugStringConvertib
     // MARK: - Database Suspension
 
     /// When this notification is posted, databases which were opened with the
-    /// `Configuration.observesSuspensionNotifications` flag are suspended.
+    /// ``Configuration/observesSuspensionNotifications`` configuration flag
+    /// are suspended.
     ///
     /// - note: [**🔥 EXPERIMENTAL**](https://github.com/groue/GRDB.swift/blob/master/README.md#what-are-experimental-features)
     public static let suspendNotification = Notification.Name("GRDB.Database.Suspend")
 
     /// When this notification is posted, databases which were opened with the
-    /// `Configuration.observesSuspensionNotifications` flag are resumed.
+    /// ``Configuration/observesSuspensionNotifications`` configuration flag
+    /// are resumed.
     ///
     /// - note: [**🔥 EXPERIMENTAL**](https://github.com/groue/GRDB.swift/blob/master/README.md#what-are-experimental-features)
     public static let resumeNotification = Notification.Name("GRDB.Database.Resume")

GRDB/Core/DatabaseWriter.swift

@@ -570,10 +570,6 @@ extension DatabaseWriter {
     /// execution of the closure. Do not store or return the database connection
     /// for later use.
     ///
-    /// It is a programmer error to call this method from another database
-    /// access method. Doing so raises a "Database methods are not reentrant"
-    /// fatal error at runtime.
-    ///
     /// - parameter updates: A closure which accesses the database.
     /// - throws: The error thrown by `updates`, or any ``DatabaseError`` that
     ///   would happen while establishing the database access or committing
@@ -608,10 +604,6 @@ extension DatabaseWriter {
     /// execution of the closure. Do not store or return the database connection
     /// for later use.
     ///
-    /// It is a programmer error to call this method from another database
-    /// access method. Doing so raises a "Database methods are not reentrant"
-    /// fatal error at runtime.
-    ///
     /// - warning: Database operations are not wrapped in a transaction. They
     ///   can see changes performed by concurrent writes or writes performed by
     ///   other processes: two identical requests performed by the `updates`

GRDB/Core/SQLRequest.swift

@@ -20,8 +20,8 @@
 /// }
 /// ```
 ///
-/// An `SQLRequest` can be created from a string literal, as in the above
-/// example, or from one of the initializers documented below.
+/// An `SQLRequest` can be created from a string literal or interpolation, as in
+/// the above examples, and from the initializers documented below.
 ///
 /// ## Topics
 ///

GRDB/Documentation.docc/DatabaseSchema.md

@@ -4,7 +4,7 @@ Learn how to define the database schema.
 
 ## Overview
 
-SQLite directly supports a [set of schema alterations](https://www.sqlite.org/lang.html). Many of them are available as `Database` methods such as ``Database/create(table:options:body:)``, ``Database/alter(table:body:)``, listed below.
+SQLite directly supports a [set of schema alterations](https://www.sqlite.org/lang.html). Many of them are available as Swift methods such as ``Database/create(table:options:body:)``, ``Database/alter(table:body:)``, listed below.
 
 You can directly create tables when you open a database, as below: