[Django] #37192: Clarify `TaskResult.last_attempted_at`

[Django]

#37192: Clarify `TaskResult.last_attempted_at`
-------------------------------------+-------------------------------------
Reporter: Johannes Maron | Type:
| Cleanup/optimization
Status: new | Component: Tasks
Version: dev | Severity: Normal
Keywords: | Triage Stage:
| Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------
Is the `last_attempted_at` starttime of the attempt or the end?
We could improve the wording, but for now updating the docstring would be
sufficient.
--
Ticket URL: <https://code.djangoproject.com/ticket/37192>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

[Django]

#37192: Clarify `TaskResult.last_attempted_at`
-------------------------------------+-------------------------------------
Reporter: Johannes Maron | Owner: (none)
Type: | Status: new
Cleanup/optimization |
Component: Tasks | Version: dev
Severity: Normal | Resolution:

Keywords: | Triage Stage:
| Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------

Description changed by Johannes Maron:

Old description:

> Is the `last_attempted_at` starttime of the attempt or the end?
> We could improve the wording, but for now updating the docstring would be
> sufficient.

New description:

> # Time the task was last attempted to be run.

Is the `last_attempted_at` starttime of the attempt or the end?

We could expand the wording, but for now updating the docstring would be
sufficient.

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

[Django]

#37192: Clarify `TaskResult.last_attempted_at`
-------------------------------------+-------------------------------------
Reporter: Johannes Maron | Owner: (none)
Type: | Status: new
Cleanup/optimization |
Component: Tasks | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage:
| Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Jake Howard):

* cc: Jake Howard (added)

Comment:

It's the **start** of the attempt, at least as implemented.

Granted I wrote it, but to me that's clear enough to not warrant a
documentation update. The "attempt" happens when the task begins
executing, which is what the timestamp indicates.
--
Ticket URL: <https://code.djangoproject.com/ticket/37192#comment:2>

[Django]

#37192: Clarify `TaskResult.last_attempted_at`
-------------------------------------+-------------------------------------
Reporter: Johannes Maron | Owner: (none)
Type: | Status: new
Cleanup/optimization |
Component: Tasks | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage:
| Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------

Comment (by Johannes Maron):

Thanks, I guessed that you were referring to the beginning of the attempt,
but maybe one more word of docs doesn't hurt. Let's have Jacob roll the
dice on this.
--
Ticket URL: <https://code.djangoproject.com/ticket/37192#comment:3>

[Django]

#37192: Clarify `TaskResult.last_attempted_at`
-------------------------------------+-------------------------------------
Reporter: Johannes Maron | Owner: (none)

Type: | Status: closed

Cleanup/optimization |
Component: Tasks | Version: dev

Severity: Normal | Resolution: wontfix

Keywords: | Triage Stage:
| Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Jacob Walls):

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

Comment:

{{{#!py
>>> random.random()
0.356077826000224
}}}
----
In the docs we have "The time when the most recent `Task` run began
execution.", so if it's a docstring-only proposal, let's avoid the churn.
--
Ticket URL: <https://code.djangoproject.com/ticket/37192#comment:4>