DOCSP-48767: Intersphinx links #28
Conversation
✅ Deploy Preview for docs-django ready!
To edit notification comments on pull requests, go to your Netlify site configuration. |
| @@ -146,11 +146,11 @@ function accepts the following arguments: | |||
| - ``db_name``: The name of the database you want to use. | |||
| - ``conn_max_age``: Configures persistent database connections. | |||
| This argument is optional. To learn more, see | |||
| `Persistent connections <{+django-docs+}/ref/databases/#persistent-database-connections>`__ | |||
| :std:ext-doc:`Persistent connections <databases/#persistent-database-connections>` | |||
There was a problem hiding this comment.
I'd expect this syntax (if MongoDB docs team didn't implement something different):
:ref:`Persistent connections <django:persistent-database-connections>`
(You can browse https://github.com/mongodb/django-mongodb-backend/tree/main/docs/source to see some working examples.)
Beware that the djadmin, lookup, setting roles require some custom configuration.
| @@ -13,7 +13,7 @@ Create an Admin Site | |||
|
|
|||
| You can create a {+framework+} admin site to edit your application's | |||
| data from a web interface. To learn more about the {+framework+} admin | |||
| site and its features, see `The Django admin site <{+django-docs+}/ref/contrib/admin/>`__ | |||
| site and its features, see :py:mod:`The Django admin site <django.contrib.admin>` | |||
There was a problem hiding this comment.
Does it work without the :py prefix? I've never needed that, and I don't think we're likely to run into collisions with other domains, but I'm not quite sure.
| <{+django-docs+}/ref/models/querysets/#field-lookups>`__ in the | ||
| ``QuerySet`` {+framework+} API reference. | ||
| To view a full list of lookup types, see | ||
| :std:ext-doc:`Field lookups <ref/models/querysets/#field-lookups>` |
There was a problem hiding this comment.
You cannot use an anchor like #field-lookups like this. If you want to link to a specific section, use :ref:, otherwise if you want to link to the document, use :doc:
Pull Request Info
PR Reviewing Guidelines
JIRA - https://jira.mongodb.org/browse/DOCSP-48767
Staging Links
Self-Review Checklist