Opened 2 years ago

Closed 2 years ago

Last modified 21 months ago

#21213 closed Cleanup/optimization (fixed)

Document how to subscribe to mailing lists without a Google account

Reported by: unaizalakain Owned by: unaizalakain
Component: Documentation Version: master
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 Changed 2 years ago by timo

  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset
  • Summary changed from mailing lists subscriptions to Document how to subscribe to mailing lists without a Google account
  • Triage Stage changed from Unreviewed to Accepted
  • Type changed from Bug to Cleanup/optimization
  • Version changed from 1.5 to master

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 Changed 2 years ago by unaizalakain

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 Changed 2 years ago by timo

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

comment:4 Changed 2 years ago by unaizalakain

Working on it ;-)

BTW, I haven't found the way of changing the "Questions/Feedback" footer of Django's documentation pages (is it embedded maybe?). 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?

Last edited 2 years ago by unaizalakain (previous) (diff)

comment:5 Changed 2 years ago by timo

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 Changed 2 years ago by unaizalakain

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

comment:7 Changed 2 years ago by unaizalakain

  • 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 Changed 2 years ago by Tim Graham <timograham@…>

  • Resolution set to fixed
  • Status changed from new to closed

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 Changed 21 months ago by Tim Graham <timograham@…>

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