#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 django-updates+unsubscr...@googlegroups.com.
To post to this group, send email to django-updates@googlegroups.com.
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.
