Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Updated Python's references to be the official docs instead of Dive Into Python. #17353

Closed
wants to merge 7 commits into from
Closed

Updated Python's references to be the official docs instead of Dive Into Python. #17353

Show file tree
Hide file tree
Changes from 4 commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
02c17b0
Added Python documentation link and removed Dive Into Python
Oct 10, 2023
df370e8
Removed an anonymous hyperlink mismatch
Oct 10, 2023
627903c
Update docs/intro/index.txt
The-Amoghavarsha Oct 10, 2023
536d2fa
omitted /3/, made few changes to the files replacing Dive Into Python
Oct 12, 2023
65dc036
removed /3/, replaced 'd' by 'D' in the Documentation
Oct 27, 2023
e761651
removed /3/
Oct 27, 2023
ba9d4e4
Added suggested changes from line 35 and 36
Oct 27, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
7 changes: 2 additions & 5 deletions docs/intro/contributing.txt
View file
Open in desktop
Expand Up @@ -26,9 +26,7 @@ Who's this tutorial for?
For this tutorial, we expect that you have at least a basic understanding of
how Django works. This means you should be comfortable going through the
existing tutorials on :doc:`writing your first Django app</intro/tutorial01>`.
In addition, you should have a good understanding of Python itself. But if you
don't, `Dive Into Python`__ is a fantastic (and free) online book for
beginning Python programmers.
In addition, you should have a good understanding of Python itself.
The-Amoghavarsha marked this conversation as resolved.
Show resolved Hide resolved

Those of you who are unfamiliar with version control systems and Trac will find
that this tutorial and its links include just enough information to get started.
Expand All @@ -45,7 +43,6 @@ so that it can be of use to the widest audience.
`#django-dev on irc.libera.chat`__ to chat with other Django users who
might be able to help.

__ https://diveinto.org/python3/table-of-contents.html
__ https://web.libera.chat/#django-dev
.. _Django Forum: https://forum.djangoproject.com/

Expand Down Expand Up @@ -350,7 +347,7 @@ This test checks that the ``make_toast()`` returns ``'toast'``.
* After reading those, if you want something a little meatier to sink
your teeth into, there's always the Python :mod:`unittest` documentation.

__ https://diveinto.org/python3/unit-testing.html
__ https://diveintopython3.net/unit-testing.html

Running your new test
---------------------
Expand Down
4 changes: 2 additions & 2 deletions docs/intro/index.txt
View file
Open in desktop
Expand Up @@ -32,10 +32,10 @@ place: read this material to quickly get up and running.
`list of Python resources for non-programmers`_

If you already know a few other languages and want to get up to speed with
Python quickly, we recommend `Dive Into Python`_. If that's not quite your
Python quickly, we recommend `Python documentation`_. If that's not quite your
style, there are many other `books about Python`_.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Python quickly, we recommend `Python documentation`_. If that's not quite your
style, there are many other `books about Python`_.
Python quickly, we recommend referring to the official `Python
documentation`_, which provides comprehensive and authoritative information
about the language, as well as links to other resources such as a list of
`books about Python`_.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have accepted the suggestion (omitting /3/), thank you :)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey @The-Amoghavarsha, I don't see my suggestion applied, would you know what happened? Thanks!

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oops, I'm extremely sorry! I thought it was edited already. It seems like it has been edited outside the commit. I think I have to update my branch.

I was also working on few changes which @ngnpope mentioned below.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@The-Amoghavarsha I still don't see the changes I suggested, do you think you could incorporate those? Thanks!


.. _python: https://www.python.org/
.. _list of Python resources for non-programmers: https://wiki.python.org/moin/BeginnersGuide/NonProgrammers
.. _Dive Into Python: https://diveinto.org/python3/table-of-contents.html
.. _Python documentation: https://docs.python.org/
.. _books about Python: https://wiki.python.org/moin/PythonBooks
2 changes: 1 addition & 1 deletion docs/ref/django-admin.txt
View file
Open in desktop
Expand Up @@ -1810,7 +1810,7 @@ Example usage:

django-admin migrate --pythonpath='/home/djangoprojects/myproject'

.. _import search path: https://diveinto.org/python3/your-first-python-program.html#importsearchpath
.. _import search path: https://docs.python.org/3/library/sys_path_init.html#sys-path-init

.. django-admin-option:: --settings SETTINGS

Expand Down
2 changes: 1 addition & 1 deletion docs/ref/templates/builtins.txt
View file
Open in desktop
Expand Up @@ -2414,7 +2414,7 @@ individual elements of the sequence.
Returns a slice of the list.

Uses the same syntax as Python's list slicing. See
https://diveinto.org/python3/native-datatypes.html#slicinglists for an
https://docs.python.org/3/tutorial/introduction.html#lists for an
introduction.

Example:
Expand Down
2 changes: 1 addition & 1 deletion docs/topics/settings.txt
View file
Open in desktop
Expand Up @@ -46,7 +46,7 @@ The value of :envvar:`DJANGO_SETTINGS_MODULE` should be in Python path syntax,
e.g. ``mysite.settings``. Note that the settings module should be on the
Python `import search path`_.

.. _import search path: https://diveinto.org/python3/your-first-python-program.html#importsearchpath
.. _import search path: https://docs.python.org/3/library/sys_path_init.html#sys-path-init
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is an incorrect anchor. Also, links to Python's documentation should use :py: directive.


The ``django-admin`` utility
----------------------------
Expand Down