Skip to content

Commit

Permalink
Merge pull request #10 from LainForge/tarun/dev
Browse files Browse the repository at this point in the history
chore: updated readme and added contrib.md
  • Loading branch information
TarunTomar122 authored Oct 5, 2023
2 parents 1eee2de + f5760e2 commit d1d3436
Show file tree
Hide file tree
Showing 4 changed files with 166 additions and 15 deletions.
2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ lerna-debug.log*
# Diagnostic reports (https://nodejs.org/api/report.html)
report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json

.jampack

# Runtime data
pids
*.pid
Expand Down
127 changes: 127 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,127 @@
# Contributor's Guide

First of all, Thanks for taking the time to contribute! 😊

**Contents**

- [Choosing an Issue](#choosing-an-issue)
- [Getting Started](#getting-started)
- [Submitting a Pull Request](#submitting-a-pull-request)
- [Getting Help](#getting-help)

## Choosing an Issue

Before getting started and setup with contributing, you'll want to look at and choose an issue to work on. Here is a basic workflow you want to work from:

1. Search through issues
2. Find issue you want to work on
3. Check if someone else has already worked on and made a pull request on said issue
4. (Optional) Double check pull requests for someone who has worked on the pull request

If you have gotten that far, then you can go ahead and work on the issue. Below are more detailed instructions based on the basic workflow above.

You can find open issue [here](https://github.com/freeCodeCamp/how-to-contribute-to-open-source/issues).

Once you've found an issue you want to work on, take a look at the issue to see if anyone else has made a pull request for this issue yet.

You can tell if someone has correctly referenced and worked on an issue if in the issue you find some text saying, the following:

> This was referenced on ____
where that `____` is the date and below it is the pull request of another individual working on that issue. [Here](https://github.com/freeCodeCamp/how-to-contribute-to-open-source/issues/822) is an example of what this looks like.

To be extra sure no one has worked on it, you can [take a look at the pull requests](https://github.com/freeCodeCamp/how-to-contribute-to-open-source/pulls) as well to see if anyone has made a similar pull request.

If you've gotten this far, then you can continue on with the next section on "Getting Started" to working on your first pull request and contribution to our repository.

### Getting Started

1. If you are new to Git and GitHub, it is advisable that you go through
[GitHub For Beginners](http://readwrite.com/2013/09/30/understanding-github-a-journey-for-beginners-part-1/)
**before** moving to Step 2.

2. Fork the project on GitHub.
[Help Guide to Fork a Repository](https://help.github.com/en/articles/fork-a-repo/).

![Illustration for How to Fork a Repository](https://hisham.hm/img/posts/github-fork.png)

3. Clone the project.
[Help Guide to Clone a Repository](https://help.github.com/en/articles/cloning-a-repository)

4. Create a branch specific to the issue you are working on.

```shell
git checkout -b update-readme-file
```

For clarity, name
your branch `update-xxx` or `fix-xxx`. The `xxx` is a short
description of the changes you're making. Examples include `update-readme` or
`fix-typo-on-contribution-md`.
5. Open up the project in your favorite text editor, select the file you want
to contribute to, and make your changes.
If you are making changes to the `README.md` file, you would need to have
Markdown knowledge. Visit
[here to read about GitHub Markdown](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)
and
[here to practice](http://www.markdowntutorial.com/).
* If you are adding a new project/organization to the README, make sure
it's listed in alphabetical order.
* If you are adding a new organization, make sure you add an organization
label to the organization name. This would help distinguish projects
from organizations.

6. Add your modified
files to Git, [How to Add, Commit, Push, and Go](http://readwrite.com/2013/10/02/github-for-beginners-part-2/).

```shell
git add path/to/filename.ext
```

**Note:** using a `git add .` will automatically add all files. You can do a
`git status` to see your changes, but do it **before** `git add`.

6. Commit your changes using a descriptive commit message.

```shell
git commit -m "Brief Description of Commit"
```

7. Push your commits to your GitHub Fork:

```shell
git push -u origin branch-name
```

8. Submit a pull request.

Within GitHub, visit this main repository and you should see a banner
suggesting that you make a pull request. While you're writing up the pull
request, you can add `Closes #XXX` in the message body where `#XXX` is the
issue you're fixing. Therefore, an example would be `Closes #42` would close issue
`#42`.

### Submitting a Pull Request

[What is a Pull Request?](https://yangsu.github.io/pull-request-tutorial/)

If you decide to fix an issue, it's advisable to check the comment thread to see if there's somebody already working on a fix. If no one is working on it, kindly leave a comment stating that you intend to work on it. By doing that,
other people don't accidentally duplicate your effort.
In a situation where somebody decides to fix an issue but doesn't follow up
for a particular period of time, say 2-3 weeks, it's acceptable to still pick
up the issue but make sure that you leave a comment.
You can open a pull request to main branch after you have pushed your code.
### Getting Help
We have a [Discord](https://discord.gg/3QXkZ8Q) server where you can ask questions and get help. Feel free to join and ask any questions you may have.
This is specially useful if you want to work on a new feature or make significant changes to the codebase.
30 changes: 27 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,29 @@
# LainForge.github.io
# About Lainforge​

We are a smol group of enthusiastic developers who love to code and learn new things.
All of our projects are open source and can be found [here](https://github.com/LainForge).

## Lainforge.github.io

This is our [website](https://lainforge.org/). It is built with [Astro](https://astro.build/)

Main features of this website are:

- `Devlogs`
- We write devlogs about our projects and you can follow the entire development process as we go.
- `Tech Posts`
- We write about tech stuff that we find interesting.

## Setup

1. Clone the repo
2. Install dependencies with `npm install`
3. Run `npm run dev` to start the dev server

## Contributing

If you want to contribute to this project, the best way to do so is by first opening an issue and then creating a pull request.
You can also join our [Discord](https://discord.gg/3QXkZ8Q) and talk to us there.


Github Actions Done!

> Removed Default Github Pages Action Workflow
22 changes: 10 additions & 12 deletions src/pages/index.astro
Original file line number Diff line number Diff line change
Expand Up @@ -25,21 +25,15 @@ const featuredProjects = sortedProjects.filter(({ data }) => data.featured);
<section id="hero">
<h1>Kon'nichiwa​ 🙇🏻</h1>
<p>
LainForge is literally the best Open Source Organization in the World!
</p>
<p>
Checkout our projects or
<LinkButton
className="hover:text-skin-accent underline underline-offset-4 decoration-dashed"
href="/about"
>
ABOUT
</LinkButton> for more info.
At LainForge,
</p>
<ul>
<li class="my-3">1. We solve <a href="/projects" class="underline-links">problems</a></li>
<li class="my-3">2. We write about <a href="/posts" class="underline-links">solving problems</a> </li>
</ul>
<p>Scroll down for more ⬇️</p>
</section>

<Hr />

{
featuredProjects.length > 0 && (
<>
Expand Down Expand Up @@ -131,4 +125,8 @@ const featuredProjects = sortedProjects.filter(({ data }) => data.featured);
.all-posts-btn-wrapper {
@apply my-8 text-center;
}

.underline-links {
@apply underline decoration-wavy decoration-1 underline-offset-4;
}
</style>

0 comments on commit d1d3436

Please sign in to comment.