Opened 11 years ago

Closed 11 years ago

Last modified 11 years ago

#21213 closed Cleanup/optimization (fixed)

Document how to subscribe to mailing lists without a Google account

Reported by: Unai Zalakain Owned by: Unai Zalakain
Component: Documentation Version: dev
Severity: Normal Keywords: mailing list, subscription, google
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: yes UI/UX: no

Description

Leaving the google-dependency as a matter for an other discussion, the way for non-google users to subscribe to this mailing lists should be made more clear in doc. The only way for non-google users to subscribe is by sending an email to:

  • django-users+subscribe@googlegroups.com
  • django-developers+subscribe@googlegroups.com

Change History (9)

comment:1 by Tim Graham, 11 years ago

Summary: mailing lists subscriptionsDocument how to subscribe to mailing lists without a Google account
Triage Stage: UnreviewedAccepted
Type: BugCleanup/optimization
Version: 1.5master

Were you planning to provide a patch since you assigned this to yourself? If not, could you indicate where in the docs you expected to see this info?

comment:2 by Unai Zalakain, 11 years ago

Yep, I was planning to submit a patch myself but I wanted to wait for some kind of feedback.

What do you think about creating a mailing list specific page instead of mentioning the django-users, django-developers and django-updates mailing lists directly on every single page? In this way, secondary information can be given without mentioning it on every single page.

comment:3 by Tim Graham, 11 years ago

Sure, I think something like docs/internals/mailing-lists.txt would be a useful addition.

comment:4 by Unai Zalakain, 11 years ago

Working on it ;-)

BTW, I haven't found the way of changing the "Questions/Feedback" footer of Django's documentation pages (maybe is it embedded?). The thing is that pointing the "post a question" link directly to "mailto:django-users@…" would be the correct thing, now it is pointing to the same place that the "archives of the django-users mailing" link does.

Any thought about how could I make this change happen?

Version 0, edited 11 years ago by Unai Zalakain (next)

comment:5 by Tim Graham, 11 years ago

It's part of a separate repo: https://github.com/django/djangoproject.com

I'm a bit hesitant to make that change though since I believe you need to be a member of the group in order to post, so it may be confusing to new users to click on that link only to have their message rejected.

comment:6 by Unai Zalakain, 11 years ago

What about making it link to the (future) mailing lists docs instead?

comment:7 by Unai Zalakain, 11 years ago

Has patch: set

https://github.com/unaizalakain/django/compare/ticket_21213

Some notes:

  • I added the django-announce mailing list
  • I made use of substitution and rst_epilog because:
    • Writing :ref:django-core-mentorship <django-core-mentorship-mailing-list> every time wasn't an option
    • Adding all mailing list substitution like .. |django-core-mentorship| replace:: :ref:django-core-mentorship <django-core-mentorship-mailing-list> to every file wasn't an option either.

If everything OK, I'll squash commits and make a pull request ;-)

comment:8 by Tim Graham <timograham@…>, 11 years ago

Resolution: fixed
Status: newclosed

In 3895d8899d7a01f2bdb1c206e45d8578a9739c91:

Fixed #21213 -- Added docs for Django's mailing lists.

Added docs/internals/mailing-lists.txt documenting the use of django's
mailing lists. All references across docs changed to point to this page.

The referencing makes use of substitution because there's no way to make
a :ref: link in a non-inline fashion in Sphinx. It also makes use of
rst_epilog Sphinx conf for making this substitutions across all the
docs.

comment:9 by Tim Graham <timograham@…>, 11 years ago

In 54b04cc8e6e4ea3f40b6320afe7e8ecfa16a8651:

[1.6.x] Fixed #21213 -- Added docs for Django's mailing lists.

Added docs/internals/mailing-lists.txt documenting the use of django's
mailing lists. All references across docs changed to point to this page.

The referencing makes use of substitution because there's no way to make
a :ref: link in a non-inline fashion in Sphinx. It also makes use of
rst_epilog Sphinx conf for making this substitutions across all the
docs.

Backport of 3895d8899d from master

Note: See TracTickets for help on using tickets.
Back to Top