Есть ли способ добавить в закладки страницу "текущей" документации Django, без номеров версий?
Рассмотрим пример. Я ищу в Django STATICFILES_DIR:
https://www.google.com/search?q=django+STATICFILES_DIRS
Довольно быстро я получаю именно то, что хочу:
https://docs.djangoproject.com/en/4.1/ref/contrib/staticfiles/
у которого есть запись конфигурации STATICFILES_DIR.
Но, обратите внимание на url, это для Django 4.1
. И на странице тоже так написано.
Но, может быть, есть текущая версия? Давайте посмотрим.
Нет.
Контраст с Python, который указывает на очень общую, 3
версию. Не на Python 3.10
или 3.11
.
https://docs.python.org/3/tutorial/datastructures.html#dictionaries
Or postgres (ищет create table):
https://www.postgresql.org/docs/14/sql-createtable.html
OK, да, у меня есть версия 14, но...
Я могу щелкнуть на этом current и это NOT привяжет меня к конкретной версии.
https://www.postgresql.org/docs/current/sql-createtable.html
В случае с Django, Python и Postgresql я уверен, что общая страница документации без версий будет служить моим целям 90% времени - это уже довольно стабильные API.
Часто поиск приводит вас к древним версиям postgresql, таким как 9.2, но вы всегда можете найти текущую ссылку.
Я не в тех местах ищу постоянную ссылку на документацию по Django?
Да, есть dev
ссылка на версии Django, но это немного опасная жизнь, я предполагаю, что люди потенциально работают над обновлением документации по текущей версии на этом URL. Или мне все-таки стоит использовать его?
Собираюсь пока использовать тег dev
. Django достаточно стабилен, чтобы я ожидал минимальных проблем, и я всегда могу вернуться к интересующей меня версии оттуда. Но по крайней мере у меня нет закладок, указывающих на кучу разных исторических версий.