Git Product home page Git Product logo

soc-portal's Introduction

SoC-Portal

Official repository for the SoC Portal Project created by TTY16

This repository is a part of HelloFOSS '23

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

Getting Started

To learn the usage of this repository and begin contributing go to the Usage section of CONTRIBUTING.md

Documentation

Frontend

This project generates documentation using StoryBook. Make sure that you add JSDoc comments for the components. To access the documentation, run the following commands on your terminal:

# installation
npm install --save-dev @storybook/react
# configuration
npx sb init
# to view the documentation
npx storybook

Backend

API Documentation

The project generates API documentation using drf-yasg, provided through Swagger and ReDoc. To access the API documentation, follow these steps:

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

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.

cd backend/docs
./make.bat html

Contributing

Check out CONTRIBUTING.md for guidelines on contributing to the repo.

soc-portal's People

Contributors

prater-12 avatar aaditya019jain avatar shiveshcodes avatar deeksha-4 avatar aastha51551 avatar akshat-singhvi avatar prater12 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.