Added django CMS Association/Slack to documentation (#6964)

This commit is contained in:
Daniele Procida 2021-01-27 11:18:04 +00:00 committed by GitHub
parent 1df448b759
commit ee3af05e70
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
13 changed files with 80 additions and 88 deletions

View File

@ -19,10 +19,7 @@ Issues and pull requests
========================
* Please report **any bugs** through `GitHub issues <https://github.com/divio/django-cms/issues>`_.
* For *help with django CMS*, please use our `users' email list <https://groups.google.com/forum/#!forum/django-cms>`_
or `StackOverflow <https://stackoverflow.com/questions/tagged/django-cms>`_.
* For *feature requests*, please use our
`developers' email list <https://groups.google.com/forum/#!forum/django-cms-developers>`_.
* Use our `Discourse forum <https://discourse.django-cms.org>`_ to discuss pull requests
* For *security issues* please see further below.
@ -39,15 +36,8 @@ Security issues
Please have a look at our security policy for
`how to deal with security issues <http://docs.django-cms.org/en/latest/contributing/development-policies.html#reporting-security-issues>`_.
If you think you have discovered a security issue in our code, please do not raise it on
* GitHub
* StackOverflow
* IRC
* Twitter
* either of our email lists
or in any other public forum until we have had a chance to deal with it.
If you think you have discovered a security issue in our code, please do not raise it in any public
forum until we have had a chance to deal with it.
Community
@ -55,15 +45,9 @@ Community
You can join us online:
* on `StackOverflow <https://stackoverflow.com/questions/tagged/django-cms>`_.
* in our IRC channel, #django-cms, on ``irc.freenode.net``. If you don't have an IRC client, you can
`join our IRC channel using the KiwiIRC web client
<https://kiwiirc.com/client/irc.freenode.net/django-cms>`_, which works pretty well.
* on our `django CMS users email list <https://groups.google.com/forum/#!forum/django-cms>`_ for
**general** django CMS questions and discussion
* on our `django CMS developers email list
<https://groups.google.com/forum/#!forum/django-cms-developers>`_ for discussions about the
**development of django CMS**
* in our `django CMS Slack channel <https://www.django-cms.org/slack>`_
* on our `Discourse forum <https://discourse.django-cms.org>`_
* on `StackOverflow <https://stackoverflow.com/questions/tagged/django-cms>`_
You can also follow:

View File

@ -8,7 +8,7 @@ Supported Versions
Security updates are provided to the latest 2 django CMS versions released. Exceptions apply to the LTS releases.
======= =========
Version Supported
Version Supported
------- ---------
3.7.x yes (LTS)
3.6.x yes
@ -21,4 +21,4 @@ Reporting a Vulnerability
If you think you have discovered a security issue in our code, please report it **privately**, by emailing us at security@django-cms.org.
Please **do not** raise it on IRC, GitHub, either of our email lists, StackOverflow or in any other public forum until we have had a chance to deal with it.
Please **do not** raise it on any public forum until we have had a chance to deal with it.

View File

@ -131,9 +131,22 @@ try:
import divio_docs_theme
html_theme = 'divio_docs_theme'
html_theme_path = [divio_docs_theme.get_html_theme_path()]
html_theme_options = {
'show_cloud_banner': True,
'cloud_banner_markup': """
<div class="divio-cloud">
<span class="divio-cloud-caption">The django CMS Association</span>
<p>The django CMS Association is a non-profit organisation that funds and
steers the development of django CMS, and nurtures its world-wide
community of developers and users.</p>
<a class="btn-neutral divio-cloud-btn" target="_blank" href="https://www.django-cms.org/en/about-us/">Join us</a>
</div>
""",
}
except:
html_theme = 'default'
show_cloud_banner = True
# The theme to use for HTML and HTML Help pages. Major themes that come with

View File

@ -26,7 +26,7 @@ Basic requirements and standards
********************************
If you're interested in developing a new feature for the CMS, it is recommended
that you first discuss it on the `django-cms-developers`_ mailing list so as
that you first discuss it on the `Discourse forum <https://discourse.django-cms.org>`_ so as
not to do any work that will not get merged in anyway.
- Code will be reviewed and tested by at least one core developer, preferably
@ -105,11 +105,9 @@ coverage will only be accepted with a very good reason; bug-fixing patches
**must** demonstrate the bug with a test to avoid regressions and to check
that the fix works.
We have an IRC channel, our `django-cms-developers`_ email list,
and of course the code reviews mechanism on GitHub - do use them.
We have `a Slack group <https://www.django-cms.org/slack>`_, a `Discourse forum
<https://discourse.django-cms.org>`_, and of course the code reviews mechanism on GitHub - do use them.
If you don't have an IRC client, you can `join our IRC channel using the KiwiIRC web client
<https://kiwiirc.com/client/irc.freenode.net/django-cms>`_, which works pretty well.
.. _contributing_frontend:

View File

@ -13,9 +13,9 @@ We will not tolerate abusive behaviour or language or any form of harassment.
Individuals whose behaviour is a cause for concern will be give a warning, and
if necessary will be excluded from participation in official django CMS
channels (email lists, IRC channels, etc) and events. The `Django Software
Foundation <http://djangoproject.com/foundation/>`_ will also be informed of
the issue.
channels (Slack group, Discourse forum, email lists, IRC channels, etc) and
events. The `Django Software Foundation
<http://djangoproject.com/foundation/>`_ will also be informed of the issue.
*****************
Raising a concern

View File

@ -6,14 +6,9 @@ django CMS's development community
You can join us online:
* in our `django CMS Slack channel <www.django-cms.org/slack>`_
* on our `django CMS users email list <https://groups.google.com/forum/#!forum/django-cms>`_ for
**general discussion** of django CMS
* on our `django CMS developers email list
<https://groups.google.com/forum/#!forum/django-cms-developers>`_ for discussions about the
**development of django CMS**
* on our `StackOverflow <https://stackoverflow.com/questions/tagged/django-cms>`_ for
general **questions** around django CMS and it's plugin ecosystem
* in our `django CMS Slack channel <https://www.django-cms.org/slack>`_
* on our `Discourse forum <https://discourse.django-cms.org>`_
* on `StackOverflow <https://stackoverflow.com/questions/tagged/django-cms>`_
You can also follow:

View File

@ -15,8 +15,8 @@ Reporting security issues
If you think you have discovered a security issue in our code, please report
it **privately**, by emailing us at `security@divio.com <security@divio.com>`_.
Please **do not** raise it on IRC, GitHub, either of our email lists, StackOverflow
or in any other public forum until we have had a chance to deal with it.
Please **do not** raise it in any public forum until we have had a
chance to deal with it.
******
@ -47,8 +47,7 @@ the author of the pull request.
Proposal and discussion of significant changes
**********************************************
New features and backward-incompatible changes should be proposed using the `django CMS developers email list
<https://groups.google.com/group/django-cms-developers>`_. Discussion should take place there before any pull requests
New features and backward-incompatible changes should be proposed using the `Discourse forum <https://discourse.django-cms.org>`_. Discussion should take place there before any pull requests
are made.
This is in the interests of openness and transparency, and to give the community a chance to participate in and
@ -68,7 +67,7 @@ The `roadmap <https://www.django-cms.org/en/roadmap/>`_ can be found on our webs
We are planning releases according to **key principles and aims**. Issues within milestones are
therefore subject to change.
The `django CMS developers email list <https://groups.google.com/group/django-cms-developers>`_ serves as gathering
The `django CMS Discourse forum <https://discourse.django-cms.org>`_ serves as gathering
point for developers. We submit ideas and proposals prior to the roadmap goals.
django CMS 3.4, surpassed by 3.7, was the first "LTS" ("Long-Term Support")
@ -215,5 +214,4 @@ New lines should be added to the top of the list.
.. _security@django-cms.org: mailto:security@django-cms.org
.. _django-cms-developers: https://groups.google.com/group/django-cms-developers
.. _freenode: http://freenode.net/

View File

@ -22,13 +22,14 @@ Raising an issue
If you think you have discovered a security issue in our code, please report
it **privately**, by emailing us at `security@divio.com <security@divio.com>`_.
Please **do not** raise it on IRC, GitHub, either of our email lists, StackOverflow
or in any other public forum until we have had a chance to deal with it.
Please **do not** raise it in any public forum until we have had a
chance to deal with it.
Except in the case of security matters, of course, you're welcome to raise issues in any way that
suits you - :ref:`on one of our email lists, or the IRC channel <development-community>` or in person
if you happen to meet another django CMS developer.
Except in the case of security matters, of course, you're welcome to raise
issues in any way that suits you - :ref:`using Discourse, or the Slack group
<development-community>` or in person if you happen to meet another django CMS
developer.
It's very helpful though if you don't just raise an issue by mentioning it to people, but actually
file it too, and that means creating a `new issue on GitHub

View File

@ -83,25 +83,36 @@ Technical reference material, for classes, methods, APIs, commands.
Join us online
**************
django CMS is supported by a friendly and very knowledgeable community.
The `django CMS Association <https://www.django-cms.org/en/about-us/>`_ is a non-profit
organisation that exists to support the development of django CMS and its community.
.. rst-class:: column column3
Our IRC channel, #django-cms, is on ``irc.freenode.net``. If you don't have an IRC client, you can
`join our IRC channel using the KiwiIRC web client
<https://kiwiirc.com/client/irc.freenode.net/django-cms>`_, which works pretty well.
Slack
=====
Join `our friendly Slack group <https:/https://www.django-cms.org/slack>`_ for
**support** and to **share ideas** and **discuss technical questions** with
other members of the community.
.. rst-class:: column column3
Our `django CMS users email list <https://groups.google.com/forum/#!forum/django-cms>`_ is for
**general discussions** and the `django CMS developers email list
<https://groups.google.com/forum/#!forum/django-cms-developers>`_ for the
**development of django CMS**.
Discourse
=========
Our `Discourse forum <https://discourse.django-cms.org>`_ is also used for
discussion of django CMS, particularly to manage its technical development process.
.. rst-class:: column column3
Our `StackOverflow <https://stackoverflow.com/questions/tagged/django-cms>`_ is for
**questions** around django CMS and it's plugin ecosystem.
StackOverflow
=============
`StackOverflow <https://stackoverflow.com/questions/tagged/django-cms>`_ is also a good place
for questions around django CMS and its plugin ecosystem.
***************

View File

@ -41,11 +41,6 @@ If you want to install django CMS into an existing project, or prefer to configu
hand, rather than using the automated installer, see :doc:`/how_to/install` and then follow the
rest of the tutorials.
Either way, you'll be able to find support and help from the numerous friendly
members of the django CMS community, either on our `mailinglist`_ or IRC
channel ``#django-cms`` on the ``irc.freenode.net`` network.
If you don't have an IRC client, you can `join our IRC channel using the KiwiIRC web client
<https://kiwiirc.com/client/irc.freenode.net/django-cms>`_, which works pretty well.
.. _mailinglist: https://groups.google.com/forum/#!forum/django-cms
Either way, you'll be able to find support and help from the numerous friendly members of the
django CMS community, either on our `Discourse forum <https://discourse.django-cms.org>`_ or `our
Slack group <https://www.django-cms.org/slack>`_.

View File

@ -2,13 +2,13 @@
Using django CMS
################
.. note:: This is a new section in the django CMS documentation, and a priority
for the project. If you'd like to contribute to it, we'd love to hear
from you - join us on the #django-cms IRC channel on `freenode`_ or
the `django-cms-developers`_ email list.
.. note::
This is a new section in the django CMS documentation, and a priority
for the project. If you'd like to contribute to it, we'd love to hear
from you - join us on `our friendly Slack group
<https://www.django-cms.org/slack>`_.
If you don't have an IRC client, you can `join our IRC channel using the KiwiIRC web client
<https://kiwiirc.com/client/irc.freenode.net/django-cms>`_, which works pretty well.
The **Using django CMS** documentation is divided into two parts.
@ -38,4 +38,3 @@ your site may have.
.. _django-cms-developers: https://groups.google.com/group/django-cms-developers
.. _freenode : http://freenode.net/

View File

@ -4,13 +4,12 @@
Reference for content editors
#############################
.. note:: This is a new section in the django CMS documentation, and a priority
for the project. If you'd like to contribute to it, we'd love to hear
from you - join us on the #django-cms IRC channel on `freenode`_ or
the `django-cms-developers`_ email list.
.. note::
If you don't have an IRC client, you can `join our IRC channel using the KiwiIRC web client
<https://kiwiirc.com/client/irc.freenode.net/django-cms>`_, which works pretty well.
This is a new section in the django CMS documentation, and a priority
for the project. If you'd like to contribute to it, we'd love to hear
from you - join us on `our friendly Slack group
<https://www.django-cms.org/slack>`_.
.. toctree::
:maxdepth: 2

View File

@ -4,13 +4,12 @@
Tutorial
########
.. note:: This is a new section in the django CMS documentation, and a priority
for the project. If you'd like to contribute to it, we'd love to hear
from you - join us on the #django-cms IRC channel on `freenode`_ or
the `django-cms-developers`_ email list.
.. note::
If you don't have an IRC client, you can `join our IRC channel using the KiwiIRC web client
<https://kiwiirc.com/client/irc.freenode.net/django-cms>`_, which works pretty well.
This is a new section in the django CMS documentation, and a priority
for the project. If you'd like to contribute to it, we'd love to hear
from you - join us on `our friendly Slack group
<https://www.django-cms.org/slack>`_.
It's strongly recommended that you follow this tutorial step-by-step. It has
been designed to introduce you to the system in a methodical way, and each