Skip to content

Commit

Permalink
edited README.md and CONTRIBUTING.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Akshat-Singhvi committed Oct 15, 2023
1 parent f583eb1 commit 5d4905d
Show file tree
Hide file tree
Showing 2 changed files with 45 additions and 34 deletions.
35 changes: 35 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,3 +10,38 @@ If you would like to contribute to the project, please follow these guidelines:
4. Push your changes to your forked repository.

5. Submit a pull request to the main repository with your branch, explaining the changes you made and any additional information that might be helpful for review.

# Usage

Clone the Git repository:

```shell
# Clone your fork of the GitHub Repo
git clone https://github.com/your_username/SoC-Portal.git
```

Install JS packages

```shell
cd frontend
npm install
```

Create Virtual Environment:

```shell
cd backend
python3 -m venv venv
./venv/Scripts/Activate.ps1 # Windows
source ./venv/bin/activate # Linux/MacOS
pip3 install -r requirements.txt
```

Run Application

```shell
# Frontend (in ./frontend/)
npm run start
# Backend (in ./backend/)
python manage.py runserver
```
44 changes: 10 additions & 34 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,39 +6,7 @@

An on-going project of the Web and Coding Club. Built using Django REST Framework and React.

# Usage

Clone the Git repository:

```shell
git clone https://github.com/wncc/SoC-Portal.git
```

Install JS packages

```shell
cd frontend
npm install
```

Create Virtual Environment:

```shell
cd backend
python3 -m venv venv
./venv/Scripts/Activate.ps1 # Windows
source ./venv/bin/activate # Linux/MacOS
pip3 install -r requirements.txt
```

Run Application

```shell
# Frontend (in ./frontend/)
npm run start
# Backend (in ./backend/)
python manage.py runserver
```

# Documentation

Expand All @@ -57,17 +25,25 @@ npx storybook

## Backend

### API Documentation
The project generates API documentation using [drf-yasg](https://github.com/axnsan12/drf-yasg), provided through Swagger and ReDoc. To access the API documentation, follow these steps:

Ensure that the project is running by executing the command mentioned in the "Usage" section.

Open a web browser and navigate to one of the following endpoint:

```bash
http://127.0.0.1:8000/redoc
http://127.0.0.1:8000/swagger
```

### Code Documentation
The documentation for the back-end source code is automatically generated by Sphinx. You can access it using the backend/docs/_build/html/index.html as an entry-point (open it on the browser).

Whenever you make any changes in the code, before making a pull request make sure you run the following commands to generate documentation for the changes you have made.

```shell
cd backend/docs
./make.bat html
```
# Contributing

Check out [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on contributing to the repo.

0 comments on commit 5d4905d

Please sign in to comment.