Skip to content

Commit

Permalink
Merge pull request #176 from COSC-499-W2023/updated_readme
Browse files Browse the repository at this point in the history
updated readme
  • Loading branch information
charviey authored Apr 7, 2024
2 parents f3e1503 + 1bf26ac commit 1066b3d
Show file tree
Hide file tree
Showing 7 changed files with 101 additions and 16 deletions.
111 changes: 101 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,109 @@
[![Open in Visual Studio Code](https://classroom.github.com/assets/open-in-vscode-718a45dd9cf7e7f842a935f5ebbe5719a5e09af4491e668f4dbf3b35d5cca122.svg)](https://classroom.github.com/online_ide?assignment_repo_id=12113659&assignment_repo_type=AssignmentRepo)
# Project-Starter

## Step 1: Download the required software
- python
- libreoffice
- mySQL (Workbench)
- Memcashed

## Step 2: Clone the repository

```commandline
git clone https://github.com/COSC-499-W2023/year-long-project-team-17.git
```
or
```commandline
git clone git@github.com:COSC-499-W2023/year-long-project-team-17.git
```

## Step 3: setup environment variables
```commandline
cp .env.example .env
```

Fill in the values of the variables in .env file


## Step 4: Create a Virtual Environment
```commandline
python -m venv virt
```

For Windows
```commandline
source virt/Scripts/activate
```

For Linux or MacOS
```commandline
source virt/bin/activate
```

## Step 5: Install the required dependencies
```commandline
pip install -r app/requirements.txt
```

## Step 6: Create the database
```commandline
python mydb.py
```

## Step 7: Make the necessary migrations to the database

```commandline
python app/manage.py make migrations
```

```commandline
python app/manage.py migrate
```

## Step 8: Start the system

```commandline
python app/manage.py runserver
```

## Run automated tests
```commandline
python app/manage.py test
```

Please use the provided folder structure for your docs (project plan, design documentation, communications log, weekly logs, and final documentation), source code, testing, etc. You are free to organize any additional internal folder structure as required by the project. Please use a branching workflow and once an item is ready, do remember to issue a PR, code review, and merge it into the develop branch and then the master branch.
```
.
├── docs # Documentation files (alternatively `doc`)
│ ├── project plan # Project plan document
│ ├── design # Getting started guide
│ ├── final # Getting started guide
│ ├── logs # Team Logs
│ └── ...
├── app # Source files
├── tests # Automated tests
├── utils # Tools and utilities
├── year-long-project-team-17 # Documentation files (alternatively `doc`)
│ ├── app
├──dcrm
├──media
├──presentation_templates
├──presentations
├──profile_pictures
├──staticfiles
├──admin
├──django_extensions
├──icon_cache
├──util
├──website
├──migrations
├──templates
├──images
├──partials
├──static
├──images
├──tests
├──.env.example
├──gitignore
├──__init__.py
├──manage.py
├──mydb.py
├──requirements.txt
│ ├── docs
│ ├── weekly logs
├── app
├── tests
├── utils
└── README.md
```
Also, update your README.md file with the team and client/project information. You can find details on writing GitHub Markdown [here](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) as well as a [handy cheatsheet](https://enterprise.github.com/downloads/en/markdown-cheatsheet.pdf).
1 change: 0 additions & 1 deletion app/README.md

This file was deleted.

1 change: 0 additions & 1 deletion docs/communication/README.md

This file was deleted.

1 change: 0 additions & 1 deletion docs/design/README.md

This file was deleted.

1 change: 0 additions & 1 deletion docs/final/README.md

This file was deleted.

1 change: 0 additions & 1 deletion docs/plan/Readme.md

This file was deleted.

1 change: 0 additions & 1 deletion tests/README.md

This file was deleted.

0 comments on commit 1066b3d

Please sign in to comment.