[Django] #23578: Use patterns everwhere in 1.7.X URL dispatcher docs to be consistent

12 views
Skip to first unread message

Django

unread,
Sep 30, 2014, 8:03:42 PM9/30/14
to django-...@googlegroups.com
#23578: Use patterns everwhere in 1.7.X URL dispatcher docs to be consistent
-------------------------------+--------------------
Reporter: alasdairnicol | Owner: nobody
Type: Uncategorized | Status: new
Component: Uncategorized | Version: 1.7
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------+--------------------
Django 1.7.X supports using a list of `url()` instances for `urlpatterns`.

In ticket #23277, it was decided to show the old `patterns` approach in
the docs, and switch to the new style in the 1.8 docs.

However, the [https://docs.djangoproject.com/en/1.7/topics/http/urls/#url-
namespaces URL Namespaces] section of the URL Dispatcher docs uses the new
style syntax. This could be a bit surprising for users unfamiliarwith the
new syntax in 1.8.

I'm going to open a small pull request which uses the old patterns syntax
everywhere on the URL Dispatcher docs page in 1.7.X.

--
Ticket URL: <https://code.djangoproject.com/ticket/23578>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

Django

unread,
Sep 30, 2014, 8:03:55 PM9/30/14
to django-...@googlegroups.com
#23578: Use patterns everwhere in 1.7.X URL dispatcher docs to be consistent
-------------------------------+-----------------------------------------
Reporter: alasdairnicol | Owner: alasdairnicol
Type: Uncategorized | Status: assigned
Component: Uncategorized | Version: 1.7
Severity: Normal | Resolution:
Keywords: | Triage Stage: Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
-------------------------------+-----------------------------------------
Changes (by alasdairnicol):

* status: new => assigned
* needs_better_patch: => 0
* needs_tests: => 0
* owner: nobody => alasdairnicol
* needs_docs: => 0


Old description:

> Django 1.7.X supports using a list of `url()` instances for
> `urlpatterns`.
>
> In ticket #23277, it was decided to show the old `patterns` approach in
> the docs, and switch to the new style in the 1.8 docs.
>
> However, the [https://docs.djangoproject.com/en/1.7/topics/http/urls

> /#url-namespaces URL Namespaces] section of the URL Dispatcher docs uses


> the new style syntax. This could be a bit surprising for users
> unfamiliarwith the new syntax in 1.8.
>
> I'm going to open a small pull request which uses the old patterns syntax
> everywhere on the URL Dispatcher docs page in 1.7.X.

New description:

Django 1.7.X supports using a list of `url()` instances for `urlpatterns`.

In ticket #23277, it was decided to show the old `patterns` approach in
the docs, and switch to the new style in the 1.8 docs.

However, the [https://docs.djangoproject.com/en/1.7/topics/http/urls/#url-
namespaces URL Namespaces] section of the URL Dispatcher docs uses the new

style syntax. This could be a bit surprising for users unfamiliar with the
new syntax in 1.8.

I'm going to open a small pull request which uses the old patterns syntax
everywhere on the URL Dispatcher docs page in 1.7.X.

--

--
Ticket URL: <https://code.djangoproject.com/ticket/23578#comment:1>

Django

unread,
Sep 30, 2014, 8:13:06 PM9/30/14
to django-...@googlegroups.com
#23578: Use patterns everwhere in 1.7.X URL dispatcher docs to be consistent
-------------------------------+-----------------------------------------
Reporter: alasdairnicol | Owner: alasdairnicol
Type: Uncategorized | Status: assigned
Component: Uncategorized | Version: 1.7
Severity: Normal | Resolution:
Keywords: | Triage Stage: Unreviewed
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
-------------------------------+-----------------------------------------
Changes (by alasdairnicol):

* has_patch: 0 => 1


Comment:

Pull request https://github.com/django/django/pull/3295/

--
Ticket URL: <https://code.djangoproject.com/ticket/23578#comment:2>

Django

unread,
Sep 30, 2014, 8:31:11 PM9/30/14
to django-...@googlegroups.com
#23578: Use patterns everwhere in 1.7.X URL dispatcher docs to be consistent
-------------------------------------+-------------------------------------
Reporter: alasdairnicol | Owner:
Type: | alasdairnicol
Cleanup/optimization | Status: assigned
Component: Documentation | Version: 1.7
Severity: Normal | Resolution:
Keywords: | Triage Stage: Ready for
Has patch: 1 | checkin
Needs tests: 0 | Needs documentation: 0
Easy pickings: 0 | Patch needs improvement: 0
| UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by collinanderson):

* component: Uncategorized => Documentation
* type: Uncategorized => Cleanup/optimization
* stage: Unreviewed => Ready for checkin


--
Ticket URL: <https://code.djangoproject.com/ticket/23578#comment:3>

Django

unread,
Sep 30, 2014, 9:04:01 PM9/30/14
to django-...@googlegroups.com
#23578: Use patterns everwhere in 1.7.X URL dispatcher docs to be consistent
-------------------------------------+-------------------------------------
Reporter: alasdairnicol | Owner:
Type: | alasdairnicol
Cleanup/optimization | Status: closed
Component: Documentation | Version: 1.7
Severity: Normal | Resolution: fixed

Keywords: | Triage Stage: Ready for
Has patch: 1 | checkin
Needs tests: 0 | Needs documentation: 0
Easy pickings: 0 | Patch needs improvement: 0
| UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Alasdair Nicol <alasdair@…>):

* status: assigned => closed
* resolution: => fixed


Comment:

In [changeset:"74c38bad1d80ff94a973f4c4608011f45e80f2d9"]:
{{{
#!CommitTicketReference repository=""
revision="74c38bad1d80ff94a973f4c4608011f45e80f2d9"
[1.7.x] Fixed #23578 -- Changed examples in docs to use patterns
}}}

--
Ticket URL: <https://code.djangoproject.com/ticket/23578#comment:4>

Reply all
Reply to author
Forward
0 new messages