[Django] #21425: Logging documentation improvement

6 views
Skip to first unread message

Django

unread,
Nov 12, 2013, 7:12:30 AM11/12/13
to django-...@googlegroups.com
#21425: Logging documentation improvement
-------------------------------+-----------------------------------
Reporter: oubiga | Owner: nobody
Type: Uncategorized | Status: new
Component: Documentation | Version: master
Severity: Normal | Keywords: logging, levels, log,
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------+-----------------------------------
'''Now https://docs.djangoproject.com/en/dev/topics/logging/ says''':

" Python defines the following log levels:

DEBUG: Low level system information for debugging purposes
INFO: General system information
WARNING: Information describing a minor problem that has occurred.
ERROR: Information describing a major problem that has occurred.
CRITICAL: Information describing a critical problem that has occurred.

[...]

The logger instance contains an entry method for each of the default log
levels:

logger.critical()
logger.error()
logger.warning()
logger.info()
logger.debug() "

'''My proposals are''':

" Python defines the following log levels:

CRITICAL: Information describing a critical problem that has occurred.
ERROR: Information describing a major problem that has occurred.
WARNING: Information describing a minor problem that has occurred.
INFO: General system information.
DEBUG: Low level system information for debugging purposes.

[...]

The logger instance contains an entry method for each of the default log
levels:

logger.critical()
logger.error()
logger.warning()
logger.info()
logger.debug() "

'''or''':

" Python defines the following log levels:

DEBUG: Low level system information for debugging purposes
INFO: General system information
WARNING: Information describing a minor problem that has occurred.
ERROR: Information describing a major problem that has occurred.
CRITICAL: Information describing a critical problem that has occurred.

[...]

The logger instance contains an entry method for each of the default log
levels:

logger.debug()
logger.info()
logger.warning()
logger.error()
logger.critical() "

--
Ticket URL: <https://code.djangoproject.com/ticket/21425>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

Django

unread,
Nov 12, 2013, 7:23:40 AM11/12/13
to django-...@googlegroups.com
#21425: Logging documentation improvement
-------------------------------------+-------------------------------------
Reporter: oubiga | Owner: nobody
Type: | Status: new
Cleanup/optimization | Version: master
Component: Documentation | Resolution:
Severity: Normal | Triage Stage: Accepted
Keywords: logging, levels, | Needs documentation: 0
log, | Patch needs improvement: 0
Has patch: 0 | UI/UX: 0
Needs tests: 0 |
Easy pickings: 1 |
-------------------------------------+-------------------------------------
Changes (by timo):

* needs_better_patch: => 0
* needs_tests: => 0
* easy: 0 => 1
* needs_docs: => 0
* type: Uncategorized => Cleanup/optimization
* stage: Unreviewed => Accepted


Comment:

The second ordering is consistent with the Python docs.

--
Ticket URL: <https://code.djangoproject.com/ticket/21425#comment:1>

Django

unread,
Nov 15, 2013, 8:39:56 AM11/15/13
to django-...@googlegroups.com
#21425: Logging documentation improvement
-------------------------------------+-------------------------------------
Reporter: oubiga | Owner: nobody
Type: | Status: closed
Cleanup/optimization | Version: master
Component: Documentation | Resolution: fixed

Severity: Normal | Triage Stage: Accepted
Keywords: logging, levels, | Needs documentation: 0
log, | Patch needs improvement: 0
Has patch: 0 | UI/UX: 0
Needs tests: 0 |
Easy pickings: 1 |
-------------------------------------+-------------------------------------
Changes (by Tim Graham <timograham@…>):

* status: new => closed
* resolution: => fixed


Comment:

In [changeset:"3ccc0253f2a29fe6f3227ca96dcab20143188b21"]:
{{{
#!CommitTicketReference repository=""
revision="3ccc0253f2a29fe6f3227ca96dcab20143188b21"
Fixed #21425 -- Made order in which loggers are introduced consistent.

Thanks oubiga for the suggestion.
}}}

--
Ticket URL: <https://code.djangoproject.com/ticket/21425#comment:2>

Reply all
Reply to author
Forward
0 new messages