Skip to content

Commit

Permalink
Update quickstart
Browse files Browse the repository at this point in the history
  • Loading branch information
bennylope committed Nov 23, 2023
1 parent 093a25a commit 14f4595
Show file tree
Hide file tree
Showing 4 changed files with 17 additions and 17 deletions.
6 changes: 6 additions & 0 deletions .readthedocs.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -7,3 +7,9 @@ build:

sphinx:
configuration: docs/conf.py

# We recommend specifying your dependencies to enable reproducible builds:
# https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
python:
install:
- requirements: "docs/requirements.txt"
4 changes: 2 additions & 2 deletions docs/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -46,9 +46,9 @@
# built documents.
#
# The short X.Y version.
version = "2.2"
version = "2.4"
# The full version, including alpha/beta/rc tags.
release = "2.2.0"
release = "2.4.0"

# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
Expand Down
22 changes: 7 additions & 15 deletions docs/getting_started.rst
Original file line number Diff line number Diff line change
Expand Up @@ -28,16 +28,15 @@ First add the application to your Python path. The easiest way is to use

pip install django-organizations

Upgrading Django for existing installations
-------------------------------------------
Quickstart Configuration
========================

If you are upgrading the Django version of an existing deployment that
deprecates South in favor of Django's native migrations, you will need to fake
the migrations for Django Organizations (if you have installed the app
directly, of course).
.. note::

Configuration
=============
If however you want to use single-table customized organization models and/or
custom *organization user* models, it may be best to treat Django organizations
as a library and *not* install it in your Django project. See the
:ref:`cookbook-advanced` section.

Ensure that you have a user system in place to connect to your organizations.

Expand All @@ -52,13 +51,6 @@ settings file.::
This should work for the majority of cases, from either simple, out-of-the-box
installations to custom organization models.

.. note::

If however you want to use single-table customized organization models and/or
custom *organization user* models, it may be best to treat Django organizations
as a library and *not* install it in your Django project. See the
:ref:`cookbook-advanced` section.

URLs
----

Expand Down
2 changes: 2 additions & 0 deletions docs/requirements.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
Sphinx==7.2.6
furo==2023.9.10

0 comments on commit 14f4595

Please sign in to comment.