Skip to content

Latest commit

 

History

History
184 lines (132 loc) · 8.1 KB

Learn.md

File metadata and controls

184 lines (132 loc) · 8.1 KB
Raw

Learn.md ✍

75per 📚

At 75% .com, our mission is to make quality education accessible to everyone. We understand the challenges students face in navigating their academic journey, and we're here to support you every step of the way with clear, concise, and reliable study materials.

Table of Contents

  1. Introduction
  2. Tech Stack
  3. Contributing
  4. Usage
  5. Resources for Beginners
  6. Documentation
  7. Code Reviews
  8. Feature Requests
  9. Spreading the Word

Introduction 🖥️

This repository contains the source code for a website designed to help college students access their study materials like quantum books, lectures, notes, past year questions (PYQ), and many more

Tech Stack 🗃️

Frontend

HTML CSS JS React.js

  • HTML:HTML (HyperText Markup Language) is a skeleton of a website, structuring content with tags and elements.
  • CSS:CSS is a style sheet language used to style web pages.It enables the application of different styles based on media types and user preferences, enhancing user accessibility and readability
  • JavaScript:JavaScript is a programming language used to add interactivity to websites.
  • React.js:A JavaScript library for building user interfaces. It allows developers to create large web applications that can update and render efficiently in response to data changes.

Backend

Node.js expressjs MongoDB

  • MongoDB: A NoSQL database that provides high performance, high availability, and easy scalability. It stores data in flexible, JSON-like documents.
  • Express.js: A minimal and flexible Node.js web application framework that provides a robust set of features for web and mobile applications.
  • Node.js: A JavaScript runtime built on Chrome's V8 JavaScript engine, enabling server-side scripting and running scripts server-side to produce dynamic web page content.

Contributing 📝

Raise and issue; Get assigned and then work on fixing the issue. We welcome contributions to 75per! Follow these steps to contribute:

  • Take a look at the existing Issues or create a new issue!

  • Fork the Repo. Then, create a branch for any issue that you are working on. Finally, commit your work.

    image

  • Create a Pull Request (PR), which will be promptly reviewed and given suggestions for improvements by the community.

  • Add screenshots or screen captures to your Pull Request to help us understand the effects of the changes proposed in your PR.

  • DON'T CREATE PRs WITHOUT CREATING ISSUE AND GETTING ASSIGNED

How to make a pull request

1. Start by making a Fork of the 75per repository. Click on the Fork symbol at the top right corner.

2. Clone your new fork of the repository in the terminal/CLI on your computer with the following command:

git clone https://github.com/<your-github-username>/75per

image

3. Navigate to the newly created PetMe project directory:

cd 75per

4. Set upstream command:

git remote add upstream https://github.com/AbhiDiva96/75per.git

5. Create a new branch:

git checkout -b YourBranchName

6. Sync your fork or your local repository with the origin repository:

  • In your forked repository, click on "Fetch upstream"
  • Click "Fetch and merge"

7. Make your changes to the source code.

8. Stage your changes and commit:

⚠️ Make sure not to commit package.json or package-lock.json file

⚠️ Make sure not to run the commands git add . or git add *. Instead, stage your changes for each file/folder

git add public
git commit -m "<your_commit_message>"

9. Push your local commits to the remote repository:

git push origin YourBranchName

10. Create a pull request!

Development Workflow

  • Always work on a new branch for each issue or feature.
  • Keep your branch up to date with the main repository's master branch.
  • Write clear and descriptive commit messages.
  • Test your changes thoroughly before submitting a pull request.

Issue Report Process

  1. Go to the project's issues section.
  2. Select the appropriate template for your issue.
  3. Provide a detailed description of the issue.
  4. Wait for the issue to be assigned before starting to work on it.

Pull Request Process 🚀

  1. Ensure that you have self reviewed your code.
  2. Make sure you have added the proper description for the functionality of the code.
  3. I have commented my code, particularly in hard-to-understand areas.
  4. Add screenshot it help in review.
  5. Submit your PR by giving the necesarry information in PR template and hang tight we will review it really soon.

Usage ⚙️

After installing the dependencies, you can start the local server:

npm run start

Navigate to http://localhost:3000 in your web browser to view the application.

Resources for Beginners 📚

Basics of Git and GitHub 📂

📍Documentation

  • Document any significant changes or additions to the codebase.
  • Provide clear explanations of the functionality, usage, and any relevant considerations.

Code Reviews 🔎

  • Be open to feedback and constructive criticism from other contributors.
  • Participate in code reviews by reviewing and providing feedback.

Feature Requests 🔥

  • Suggest new features or improvements that would enhance the project.

Spreading the Word 👐

  • Share your experience and the project with others.
  • Spread the word about the project on social media, developer forums, or any relevant community platforms.

Thank you for contributing to 75per! Together, we can make a significant impact. Happy coding! 🚀

Don't forget to ⭐ the repository!