|
4 | 4 |
|
5 | 5 | This is the official repository for CodeDevils' website. It's built using the [Next.js](https://nextjs.org) framework, [Tailwind CSS](https://tailwindcss.com/), and [TypeScript](https://www.typescriptlang.org/). The website is hosted on [Vercel](https://vercel.com). |
6 | 6 |
|
7 | | -## Why are there `.js` files in here? |
8 | 7 |
|
9 | | -As per [T3-Axiom #3](https://github.com/t3-oss/create-t3-app/tree/next#3-typesafety-isnt-optional), we take typesafety as a first class citizen. Unfortunately, not all frameworks and plugins support TypeScript which means some of the configuration files have to be `.js` files. |
| 8 | +## The Project |
10 | 9 |
|
11 | | -We try to emphasize that these files are javascript for a reason, by explicitly declaring its type (`cjs` or `mjs`) depending on what's supported by the library it is used by. Also, all the `js` files in this project are still typechecked using a `@ts-check` comment at the top. |
| 10 | +Packages: |
12 | 11 |
|
13 | | -## Contributing (Getting Started) |
| 12 | +- [PNPM](https://pnpm.io/installation) |
| 13 | +- [Node.js](https://nodejs.org/en/download/) |
| 14 | +- [Git](https://git-scm.com/downloads) |
14 | 15 |
|
15 | | -1. Pre-requisites: |
| 16 | +Installing the project: |
16 | 17 |
|
17 | | - - [PNPM](https://pnpm.io/installation) |
18 | | - - [Node.js](https://nodejs.org/en/download/) |
19 | | - - [Git](https://git-scm.com/downloads) |
20 | | - |
21 | | -2. Clone the repository: |
| 18 | +1. Clone the repository: |
22 | 19 | ```sh |
23 | 20 | git clone https://github.com/ASU-CodeDevils/codedevils.org.git |
24 | 21 | ``` |
25 | | -3. Install the dependencies: |
| 22 | +2. Install the dependencies: |
26 | 23 | ```sh |
27 | 24 | pnpm install |
28 | 25 | ``` |
29 | | -4. Run the development server: |
| 26 | +3. Run the development server: |
30 | 27 | ```sh |
31 | 28 | pnpm dev |
32 | 29 | ``` |
33 | 30 |
|
34 | | -## Contributing (Code Style) |
35 | | - |
36 | | -This project uses [Prettier](https://prettier.io/) and [ESLint](https://eslint.org/) to enforce code style. Please make sure to run `pnpm format`, then `pnpm lint` before committing your changes. |
37 | | - |
38 | | -## Contributing (Commit Messages) |
39 | | - |
40 | | -This project uses [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) to enforce a consistent commit message format. Please make sure to follow the commit message format when making changes. |
41 | | - |
42 | | -``` |
43 | | -<type>[optional scope]: <description> |
44 | | -
|
45 | | -[optional body] |
| 31 | +## Contributing |
46 | 32 |
|
47 | | -[optional footer(s)] |
| 33 | +[Check out our Contribution Guide here!](https://github.com/ASU-CodeDevils/codedevils.org/blob/main/.github/CONTRIBUTING.MD) |
48 | 34 |
|
49 | | -``` |
50 | 35 |
|
51 | | -## Contributing (Pull Requests) |
| 36 | +## Creating Issues |
52 | 37 |
|
53 | | -Please make sure to follow the pull request template when creating a pull request. |
| 38 | +[Check out our Issue Creation Guide here!](https://github.com/ASU-CodeDevils/codedevils.org/blob/main/.github/ISSUE_GUIDE.MD) |
0 commit comments