New submission from Erlend E. Aasland <erlend.aasl...@innova.no>:

The sqlite3 docs could need a little makeover. Here's some things that could be 
improved:

- avoid addressing the reader as "you"
- avoid using affirmative tone
- establish a "Security Considerations" or "Common Mistakes" section, instead 
of littering the docs with warnings


See also:
- https://devguide.python.org/documenting/#style-guide

----------
assignee: docs@python
components: Documentation
messages: 405349
nosy: docs@python, erlendaasland
priority: normal
severity: normal
status: open
title: [doc] improve sqlite3 docs
versions: Python 3.10, Python 3.11, Python 3.9

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue45677>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to