#28290: Doc sections are missing target (labels) links
-------------------------------------+-------------------------------------
Reporter: Tony Narlock | Owner: Kees Hink
Type: | Status: assigned
Cleanup/optimization |
Component: Documentation | Version: 1.11
Severity: Normal | Resolution:
Keywords: docs labels | Triage Stage: Accepted
intersphinx |
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Kees Hink):
* owner: Kamalesh Palanisamy => Kees Hink
Comment:
To make sure i understand the issue correctly: What is missing is the link
to the source code. There's a working example of such a `[source]` link in
https://docs.djangoproject.com/en/2.2/howto/custom-management-
commands/#django.core.management.BaseCommand. That link takes you to
https://docs.djangoproject.com/en/2.2/_modules/django/core/management/base/#BaseCommand.
I think this is also the intended behavior for the reported pages, because
there's a `class` directive.
When i follow the instruction to add a header below the `class` directive,
i get these errors:
{{{
/Users/kees/Projects/django/docs/topics/http/sessions.txt:434: WARNING:
py:meth reference target not found: backends.base.SessionBase.flush
/Users/kees/Projects/django/docs/topics/http/sessions.txt:443: WARNING:
py:meth reference target not found:
backends.base.SessionBase.set_test_cookie
/Users/kees/Projects/django/docs/topics/http/sessions.txt:443: WARNING:
py:meth reference target not found:
backends.base.SessionBase.test_cookie_worked
/Users/kees/Projects/django/docs/topics/http/sessions.txt:454: WARNING:
py:meth reference target not found:
backends.base.SessionBase.delete_test_cookie
/Users/kees/Projects/django/docs/topics/http/sessions.txt:585: WARNING:
py:meth reference target not found: backends.base.SessionBase.set_expiry
/Users/kees/Projects/django/docs/topics/http/sessions.txt:694: WARNING:
py:meth reference target not found:
backends.base.SessionBase.clear_expired
}}}
So probably this is the right direction, but sphinx can't find all methods
in the code. Why, i have no idea. There are no errors for the other
referenced methods from `backends.base.SessionBase` (like
`get_expiry_date()`).
--
Ticket URL: <https://code.djangoproject.com/ticket/28290#comment:7>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/062.bc78e85a587bbc0afe04921d161486da%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
