Currently, a lot of the sqlite3 code examples are included into Doc/library/sqlite3.rst using literalincludes. This implies that they are not included in doctests, so making sure they work is a continuous task that needs to be done manually by the maintainer. Also, sqlite3 stands out with this practice; very few other stdlib modules include code examples using literalinclude.
Suggesting to inline all examples, because of the following benefits:
- make it possible to doctest all examples
- keep the examples together with the text, instead of fragmenting it over multiple files
Currently, a lot of the sqlite3 code examples are included into
Doc/library/sqlite3.rstusingliteralincludes. This implies that they are not included in doctests, so making sure they work is a continuous task that needs to be done manually by the maintainer. Also, sqlite3 stands out with this practice; very few other stdlib modules include code examples usingliteralinclude.Suggesting to inline all examples, because of the following benefits: