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

Created and updated the Learn.md file #55

Merged
merged 7 commits into from
Jun 18, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
181 changes: 181 additions & 0 deletions Learn.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,181 @@
# Learn.md ✍
# Campus-Space 🖥️
Campus Space is a MERN stack project with TypeScript & Tailwind CSS. Admins manage timetables, teacher absences, & rooms. Students & teachers view timetables, vacant rooms, & teacher absences. Teachers can book rooms for classes. Efficient college resource management.
![image](https://github.com/debangi29/campus-space/assets/117537653/1daa0a8c-5f04-48f8-ae6b-8909e5464a70)


# Table of Contents
1. [Tech Stack](#tech-stack)
2. [Contributing](#contributing-)
- [Development Workflow](#development-workflow)
- [Issue Report Process](#issue-report-process)
- [Pull Request Process](#pull-request-process-)
3. [Setting Up on your machine](#setting-up-on-your-machine)
4. [Usage](#usage)
5. [Resources for Beginners](#resources-for-beginners-)
- [Basics of Git and GitHub](#basics-of-git-and-github-)
6. [Documentation](#documentation)
7. [Code Reviews](#code-reviews-)
8. [Feature Requests](#feature-requests-)
9. [Spreading the Word](#spreading-the-word-)


## Tech Stack

- MongoDB
- Express
- React
- Node. js
- Tailwind CSS
- TypeScript


## Contributing 📝
Raise and issue; Get assigned and then work on fixing the issue.
We welcome contributions to Campus-Space! Follow these steps to contribute:

1. **Fork the Repository**: Create your own copy of the repository on your GitHub account.
![image](https://github.com/debangi29/campus-space/assets/117537653/103e7c8d-965b-4f49-a35d-6d8b9ee4373f)


2. **Clone the Repository** : Clone the repository for making commits.
```bash
git clone https://github.com/your-username/Campus-Space.git
```
<br>

![image](https://github.com/debangi29/campus-space/assets/117537653/452f15e8-fcff-40f2-aaeb-7bedab300079)


3. **Create a New Branch** for your feature or bug fix: Make a separate branch to work on specific features or fixes and switch to the correct branch.
```bash
git checkout -b <new-branch-name>
```
4. **Make Changes** and commit them: Implement your changes and save them with a descriptive commit message.
```bash
git add .
git commit -m "Describe your changes"
```
5. **Push Your Changes** to your fork: Upload your committed changes to your GitHub fork.
```bash
git push origin <branch_name>
```
6. **Create a Pull Request ✅**: Propose your changes to be merged into the original repository.
<br>
![image](https://github.com/debangi29/campus-space/assets/117537653/67412ea9-2a97-44b0-bd94-58b747e6dc05)


### 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.

# Setting Up on your machine

Follow these steps to set up the project locally:

Clone the project

```bash
git clone https://github.com/sethshivam11/campus-space.git
```

Go to the project directory

```bash
cd campus-space
```

Install dependencies

```bash
npm run build
```

Start the server

```bash
npm run start
```


## Environment Variables

To run this project, you will need to add the following environment variables to your .env file

`MONGODB_URI`

`PORT`

`ACCESS_TOKEN_SECRET`

`NODE_ENV`

* [Click Here](https://github.com/sethshivam11/campus-space/blob/master/.env.sample) for Server Side .env.sample file.

> If you want to change the name of the college, image or footer links edit the env.production file in the client folder
`VITE_COLLEGE_NAME`
`VITE_TWITTER`
`VITE_GITHUB`
`VITE_LINKEDIN`
`VITE_LOGO`

* [Click Here](https://github.com/sethshivam11/campus-space/blob/master/client/.env.sample) for Client Side .env.sample file.


## Usage

### 1. Register a new account or log in with an existing account.
![image](https://github.com/debangi29/campus-space/assets/117537653/2f3f7af9-9c16-48c3-a6cc-e840602e36af)

### 2. You can get all the details about vacant rooms, Your timetable, Teachers absent, list of classes available at a particular period of time
![image](https://github.com/debangi29/campus-space/assets/117537653/9ae254e3-98a3-4494-b258-989f9e19c006)


### 3. There are more features and various ways to connect.
<br>

## **Contributions are welcome!. You can suggest features to add, report any possible bug that might crept in, ideas and changes! 🚀**

## Resources for Beginners 📚
### Basics of Git and GitHub 📂
- [Forking a Repo](https://help.github.com/en/articles/fork-a-repo)
- [Cloning a Repo](https://help.github.com/en/articles/cloning-a-repository)
- [Creating a Pull Request](https://help.github.com/en/articles/creating-a-pull-request)
- [Getting Started with Git and GitHub](https://guides.github.com/introduction/git-handbook/)
- [Learn GitHub from Scratch](https://www.youtube.com/watch?v=w3jLJU7DT5E)


## 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 Campus-Space! Together, we can make a significant impact. Happy coding! 🚀
## Don't forget to ⭐ the repository!
Loading