Merge pull request #9973 from ZZiigguurraatt/skip-native-sql-migration-doc-update

sqldb: clarify native sql options in `lnd.conf`

sample-lnd.conf

@@ -1489,13 +1489,19 @@
 ; db.no-rev-log-amt-data=false
 
 ; If set to true, native SQL will be used instead of KV emulation for tables
-; that support it already. Note: this is an experimental feature, use at your
-; own risk.
+; that support it.
+; Subsystems which support native SQL tables:
+; - Invoices
 ; db.use-native-sql=false
 
 ; If set to true, the KV to native SQL migration will be skipped. Note that
 ; this option is intended for users who experience non-resolvable migration
-; errors.
+; errors. Enabling after there is a non-resolvable migration error that resulted
+; in an incomplete migration will cause that partial migration to be abandoned
+; and ignored and an empty database will be used instead. Since invoices are
+; currently the only native SQL database used, our channels will still work but
+; the invoice history will be forgotten. This option has no effect if native SQL
+; is not in use (db.use-native-sql=false).
 ; db.skip-native-sql-migration=false
 
 [etcd]