Search code examples
djangodocumentation

Is there any way to bookmark a Django "current" documentation page, without version numbers?


The point of this is to keep notes/urls pointing to particular parts of the documentation that people want to refer to in the future. For example, when something is a complex feature that requires a little bit of review most of the times you work with it.


Let's take an example. I search for Django STATICFILES_DIR:

https://www.google.com/search?q=django+STATICFILES_DIRS

Pretty quickly I get exactly what I want:

https://docs.djangoproject.com/en/4.1/ref/contrib/staticfiles/

which has a STATICFILES_DIR configuration entry.

But, notice from the url, this is for Django 4.1. And it says so on the page too.

enter image description here

But maybe there are a current version? Let's look.

There isn't.

enter image description here

Contrast with Python, which points to a very generic, 3 version. Not to Python 3.10 or 3.11.

https://docs.python.org/3/tutorial/datastructures.html#dictionaries

Or postgres (looking for create table):

https://www.postgresql.org/docs/14/sql-createtable.html

OK, yes, I have a version 14, but...

enter image description here

I can click on that current and that will NOT pin me to a particular version.

https://www.postgresql.org/docs/current/sql-createtable.html

In the case of Django, Python and Postgresql, I am pretty confident a generic, version-less documentation page will serve my purposes just fine 90% of the time - those are pretty stable APIs by now.

Often searching gets you to ancient postgresql versions like 9.2, but you can always find a current link.

Am I looking in the wrong places for a permanent link for Django docs?

Yes, there is dev link on the Django versions, but that's living a bit dangerously, I assume people are potentially working updating the docs on the current version on that URL. Or should I use that after all?


Solution

  • You can do so with "stable" as a replacement for the version number:

    https://docs.djangoproject.com/en/stable/ref/contrib/staticfiles/