Skip to content

Commit 6042b30

Browse files
authored
Merge pull request #149 from adamspd/documentation-website
Added the new documentation website link
2 parents f9be140 + 50f09c9 commit 6042b30

File tree

1 file changed

+16
-11
lines changed

1 file changed

+16
-11
lines changed

README.md

Lines changed: 16 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22

33
![Tests](https://github.com/adamspd/django-appointment/actions/workflows/tests.yml/badge.svg)
44
![Published on PyPi](https://github.com/adamspd/django-appointment/actions/workflows/publish.yml/badge.svg)
5+
[![Doc](https://github.com/adamspd/django-appointment-doc/actions/workflows/build-docs.yml/badge.svg)](https://django-appt-doc.adamspierredavid.com/overview.html)
56
[![Current Release Version](https://img.shields.io/github/release/adamspd/django-appointment.svg?style=flat-square&logo=github)](https://github.com/adamspd/django-appointment/releases)
67
[![pypi Version](https://img.shields.io/pypi/v/django-appointment.svg?style=flat-square&logo=pypi&logoColor=white)](https://pypi.org/project/django-appointment/)
78
[![PyPi downloads](https://static.pepy.tech/personalized-badge/django-appointment?period=total&units=international_system&left_color=grey&right_color=orange&left_text=pip%20downloads)](https://pypi.org/project/django-appointment/)
@@ -16,6 +17,9 @@
1617
[![Django compatible version](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/adamspd/django-appointment/main/django_compatible.json)](https://github.com/adamspd/django-appointment/blob/main/compatibility_matrix.md)
1718
[![Python compatible version](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/adamspd/django-appointment/main/python_compatible.json)](https://github.com/adamspd/django-appointment/blob/main/compatibility_matrix.md)
1819

20+
🆕 **New**: The documentation website is now
21+
available [here](https://django-appt-doc.adamspierredavid.com/overview.html). It includes reasons for using the
22+
application, its features, and detailed configuration instructions.
1923

2024
⚠️ **IMPORTANT**: If upgrading from a version before 2.x.x, please note significant database changes were introduced in
2125
version 2.0.0. Please read
@@ -98,14 +102,14 @@ see their [release notes](https://github.com/adamspd/django-appointment/tree/mai
98102
AUTH_USER_MODEL = 'client.UserClient'
99103
```
100104

101-
But if you're using the default Django user model (like most of us), there's no need to add this line since Django
105+
But if you're using the default Django user model (like most of us), there's no need to add this line since Django
102106
automatically sets it to:
103107

104108
```python
105109
AUTH_USER_MODEL = 'auth.User'
106110
```
107111

108-
Ensure your `create_user` function includes the following arguments, even if they are not all used (in case you're
112+
Ensure your `create_user` function includes the following arguments, even if they are not all used (in case you're
109113
using a custom user model with your own logic for creating users):
110114

111115
```python
@@ -131,7 +135,7 @@ see their [release notes](https://github.com/adamspd/django-appointment/tree/mai
131135
To be able to send email reminders after adding `django_q` to your `INSTALLED_APPS`, you must add this variable
132136
`Q_CLUSTER` in your Django's `settings.py`. If done, and users check the box to receive reminders, you and them
133137
will receive an email reminder 24 hours before the appointment.
134-
138+
135139
Here's a configuration example, that you can use without modification (if you don't want to do much research):
136140

137141
```python
@@ -146,7 +150,7 @@ see their [release notes](https://github.com/adamspd/django-appointment/tree/mai
146150
}
147151
```
148152

149-
5. Next would be to create the migrations and run them by doing `python manage.py makemigrations appointment` and right
153+
5. Next would be to create the migrations and run them by doing `python manage.py makemigrations appointment` and right
150154
after, run `python manage.py migrate` to create the appointment models.
151155

152156
6. Start the Django Q cluster with `python manage.py qcluster`.
@@ -186,15 +190,15 @@ Here's how you can set it up:
186190
cd django-appointment
187191
```
188192

189-
2. **Prepare an .env File**: Create an `.env` file in the root directory of your project with your configuration
193+
2. **Prepare an .env File**: Create an `.env` file in the root directory of your project with your configuration
190194
settings.
191195
You should include your email host user and password for Django's email functionality (if you want it to work):
192196

193197
```plaintext
194198
195199
EMAIL_HOST_PASSWORD=your_password
196200
```
197-
201+
198202
> **Note:** The `.env` file is used to store sensitive information and should not be committed to version control.
199203
200204
3. **Build and Run the Docker Containers**: Run the following command to build and run the Docker containers:
@@ -218,8 +222,8 @@ Here's how you can set it up:
218222
```bash
219223
docker compose exec web python manage.py makemigrations appointment
220224
```
221-
222-
Then, apply the migrations with the following command:
225+
226+
Then, apply the migrations with the following command:
223227
```bash
224228
docker-compose exec web python manage.py migrate
225229
```
@@ -251,7 +255,7 @@ Here's how you can set it up:
251255
```
252256
253257
> **Note:** I used the default database settings for the Docker container.
254-
> If you want to use a different database, you can modify the Dockerfile and docker-compose.yml files to use your
258+
> If you want to use a different database, you can modify the Dockerfile and docker-compose.yml files to use your
255259
> preferred database.
256260
257261
## Customization 🔧
@@ -265,9 +269,10 @@ Here's how you can set it up:
265269
## Compatibility Matrix 📊
266270

267271
A compatibility matrix is available to help you determine which versions of Django and Python are compatible with the
268-
package.
272+
package.
269273
The matrix is updated regularly to reflect the latest compatibility test results. For more information, please
270-
refer to the [compatibility matrix here](https://github.com/adamspd/django-appointment/blob/main/compatibility_matrix.md).
274+
refer to
275+
the [compatibility matrix here](https://github.com/adamspd/django-appointment/blob/main/compatibility_matrix.md).
271276

272277
## Support 💬
273278

0 commit comments

Comments
 (0)