Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: project structure #281

Closed
1 task
fyliu opened this issue May 2, 2024 · 0 comments · Fixed by #350
Closed
1 task

docs: project structure #281

fyliu opened this issue May 2, 2024 · 0 comments · Fixed by #350
Assignees
Labels
complexity: medium feature: docs: team guide Same as PD team documentation? role: dev lead s: PD team stakeholder: People Depot Team size: 2pt Can be done in 7-12 hours

Comments

@fyliu
Copy link
Member

fyliu commented May 2, 2024

Overview

We need to create an explanation page for the project directory structure so that new devs can understand where everything is and should go.

Action Items

  • Add a new page, something like project_structure.md and lay out and explain the project structure

Resources/Instructions

  • docs/ for documentation
  • app/ for the django application and also where the docker container's project root is
  • scripts/ to store helper scripts callable from outside docker
  • etc.

All the project files (some project-specific content omitted)

tree -L 4 -I __pycache__ -I venv -I __init__.py
├── app                                                                                                                                                                                                                                        
│   ├── core                                                                                                                                                                                                                                   
│   │   ├── admin.py                                                                                                                                                                                                                           
│   │   ├── api                                                                                                                                                                                                                       
│   │   │   ├── permissions.py                                                                                                                                                                                                                 
│   │   │   ├── serializers.py                                                                                                                                                                                                                 
│   │   │   ├── urls.py                                                                                                                                                                                                                        
│   │   │   └── views.py
│   │   ├── apps.py
│   │   ├── initial_data/
│   │   ├── migrations
│   │   │   ├── 0001_initial.py
│   │   │   ├── ...
│   │   │   └── max_migration.txt
│   │   ├── models.py
│   │   ├── scripts/
│   │   ├── tests
│   │   │   ├── conftest.py
│   │   │   ├── test_api.py
│   │   │   ├── test_models.py
│   │   │   └── test_permissions.py
│   │   └── utils
│   │       └── jwt.py
│   ├── data
│   │   └── migrations
│   │       ├── ...
│   │       └── max_migration.txt
│   ├── Dockerfile
│   ├── entrypoint.sh
│   ├── erd.png
│   ├── manage.py
│   ├── peopledepot
│   │   ├── asgi.py
│   │   ├── settings.py
│   │   ├── urls.py
│   │   └── wsgi.py
│   ├── requirements.in
│   ├── requirements.txt
│   ├── scripts
│   │   └── convert.py
│   ├── setup.cfg
│   └── tmp.md
├── CONTRIBUTING.md
├── docker-compose.yml
├── docs/
├── LICENSE
├── mkdocs.yml
├── pyproject.toml
├── README.md
└── scripts
    ├── buildrun.sh
    ├── check-migrations.sh
    ├── createsuperuser.sh
    ├── db.sh
    ├── erd.sh
    ├── lint.sh
    ├── loadenv.sh
    ├── logs.sh
    ├── migrate.sh
    ├── precommit-check.sh
    ├── run.sh
    ├── start-local.sh
    ├── test.sh
    └── update-dependencies.sh
  • scripts, docs, initial data should be documented in their own pages
@fyliu fyliu added size: 2pt Can be done in 7-12 hours s: PD team stakeholder: People Depot Team role: dev lead feature: docs: PD team documentation documentation on PD team processes and architecture, etc. labels May 2, 2024
@fyliu fyliu added this to the v0.01 - initial setup milestone May 2, 2024
@fyliu fyliu changed the title Document project structure [docs] Document project structure May 17, 2024
@fyliu fyliu added feature: docs: team guide Same as PD team documentation? and removed feature: docs: PD team documentation documentation on PD team processes and architecture, etc. labels Jun 3, 2024
@fyliu fyliu changed the title [docs] Document project structure [docs] project structure Jun 3, 2024
@fyliu fyliu self-assigned this Jun 4, 2024
@shmonks shmonks moved this to In progress (actively working) in P: PD: Project Board Jun 7, 2024
@fyliu fyliu changed the title [docs] project structure docs: project structure Jun 10, 2024
@github-project-automation github-project-automation bot moved this from In progress (actively working) to Done in P: PD: Project Board Sep 4, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
complexity: medium feature: docs: team guide Same as PD team documentation? role: dev lead s: PD team stakeholder: People Depot Team size: 2pt Can be done in 7-12 hours
Projects
Status: ✅Done
Development

Successfully merging a pull request may close this issue.

2 participants