I have an application which uses the django admin interface extensively.
Some things in the admin GUI need explanations (domain/model specific docs).
We use sphinx and screenshots do explain details.
Is there a generic/automated way to create hyperlinks from the django admin interface of a model instance to the matching part in the docs?
I know that I could alter the admin templates of the models, but somehow I guess someone has a better idea how to solve this in a more professional way.
In my case the docs get hosted on the same server. AFAIK this is needed if you have the big dream, that there are links from the docs into the django application, too (but this is a different question).
What do I mean with "matching part in the docs"?
Imagine I have a model called "Foo".
And I have docs for the model (including images).
Now I would like to have a hyperlink from the admin page of the model to the docs for the model "Foo".
I think this is a very general issue. I think it is a pity that neither the framework nor a third party app help to write integrated docs.
__doc__
), but that shouldn't really make a big difference, as I suppose that the links to the docs follow a single scheme. If that's the case I'd create a property in the model that returns the link and then in the modeladmin display that property as a readonly field. – cezar Aug 27 '18 at 10:12__doc__
). – guettli Aug 27 '18 at 10:38