Creating a Django app with docs and part 4 of section 2 "Writing Views" does not properly instruct the reader how to perform the steps properly and the project come out differently than explain so as the reader cannot continue to complete the walkthru

1

I am following the documentation to “Deploy A Django Project” on Render’s documentation. I’m starting with their tutorial from scratch so the beginning is technically the “Create A New Django Project” section. I’ve finished the first section for the installation and setup.

As I reach the next section I made it through the first 3 steps of creating a landing page. Once I get to the 4th section the folder structure they are saying the project should look like doesnt make sense. When I follow the instructions the docs tell me to do and then whenit eells you how the folder structure should look and how their github render django example repo(not allowed to post a link here) looks it doesnt look how the instructions explain step by step before hand.

Up to step 4 my project folder structure looks like this

mysite
├── homepage 
    ├── __pycache__
    ├── migrations
    ├── tempates
            ├── homepage
                ├──index.html 
    ├── __init__.py
    ├── admin.py
    ├── apps.py
    ├── models.py
    ├── tests.py
    ├── urls.py
    ├── views.py
├── mysite
    ├── __pycache__
    ├── __init__.py
    ├── asgi.py
    ├── settings.py
    ├── urls.py
    ├── wsgi.py
├── venv
├── db.sqlite3
├── manage.py
├── requirements.txt

Now in step 4 the docs says to " Configure the Django project to point to the homepage application’s urls module. Open mysite/urls.py and update the from django.urls import path line to add the include module, and then include the homepage application’s URLs module to our urlpatterns , like so:"

from django.contrib import admin
from django.urls import path, include
urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('homepage.urls')),]

“Your folder structure should now look like this:”

render
├── __init__.py
├── admin.py
├── apps.py
├── migrations
│   └── __init__.py
├── models.py
├── templates
│   └── render
│       └── index.html
├── tests.py
├── urls.py
└── views.py

Now if you look at the github youll notice that the [github repo]looks like this:

django
├──mysite
    ├──__init__.py
    ├── asgi.py
    ├── settings.py
    ├── urls.py
    ├── wsgi.py
├──render
    ├── migrations
    ├── static/render
    ├── templates/render
    ├── __init__.py
    ├── admin.py
    ├── models,py
    ├── tests.py
    ├── urls.py
    ├── views.py
├──.gitignore
├──CONTRIBUTORS.txt
├──LICENSE
├──README.md
├──build.sh
├──manage.py
├──render.yaml
├──requirements,txt

So as you see what your docs say do nd what results are needed to be yielded to deploy are not adequately explained past step 3.

For example my questions are:
1 Should I have a home page directory or a render directory in the root?
2 Why do the docs not explain this correctly so I can continue.
3 What are the proper next steps so i can complete the project and continue to the rest of the documentation so i can successfully deploy on render
4. Im tired of typing i have more questions but ill figure it out later

2

Hi there,

You are probably right, this section could be clearer and include the fill folder structure. This section is specifically focused on this part:

├── homepage  ├── __pycache__ ├── migrations ├── tempates ├── homepage ├──index.html  ├── __init__.py ├── admin.py ├── apps.py ├── models.py ├── tests.py ├── urls.py ├── views.py

It also has the mistake that render should be homepage.

I’ll look to update this. Is there anything in the documents which is stopping your from progressing?

Regards,

Keith
Render Support, UTC+10 :australia: