Skip to content

Commit 9f7c9ae

Browse files
authored
Merge pull request #2 from imlargo/migration
Update README to reflect Gin website details and contribution guidelines
2 parents 3eea97a + 28289f1 commit 9f7c9ae

File tree

1 file changed

+32
-12
lines changed

1 file changed

+32
-12
lines changed

README.md

+32-12
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,37 @@
1-
# Starlight Starter Kit: Basics
1+
# Gin website
22

3-
[![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)
3+
[![Run Deploy](https://github.com/gin-gonic/website/actions/workflows/node.yml/badge.svg)](https://github.com/gin-gonic/website/actions/workflows/node.yml)
44

5-
```
6-
npm create astro@latest -- --template starlight
7-
```
5+
Welcome! This repository houses all the assets required to build the Gin website and documentation. We're pleased that you want to contribute! The website is hosted at https://gin-gonic.com.
6+
7+
We use [Astro](https://astro.build) to format and generate our website, the [Starlight](https://starlight.astro.build) template for styling and site structure. Thanks!.
8+
9+
## Contribution
10+
11+
- Fork the repository
12+
13+
You can click the Fork button in the upper-right area of the screen to create a copy of this repository in your GitHub account. This copy is called as fork.
14+
15+
- Create one pull request
816

9-
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics)
10-
[![Open with CodeSandbox](https://assets.codesandbox.io/github/button-edit-lime.svg)](https://codesandbox.io/p/sandbox/github/withastro/starlight/tree/main/examples/basics)
11-
[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/withastro/starlight&create_from_path=examples/basics)
12-
[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fwithastro%2Fstarlight%2Ftree%2Fmain%2Fexamples%2Fbasics&project-name=my-starlight-docs&repository-name=my-starlight-docs)
17+
Make any changes you want in your fork, and when you are ready to send those changes to us, go to your fork and create a new pull request to let us know about it.
18+
19+
- Merge the pull request
20+
21+
Once your pull request is created, a Gin reviewer will take responsibility for providing clear, actionable feedback, re-improve and merge.
22+
23+
## Running
24+
25+
See the [official Astro documentation](https://docs.astro.build/en/getting-started) for Astro installation instructions. and [Starlight documentation](https://starlight.astro.build/getting-started) for Starlight installation instructions.
26+
27+
To run the site locally when you have Hugo installed:
28+
29+
```sh
30+
npm install
31+
npm run dev
32+
```
1333

14-
> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
34+
This will start the local Astro server on port 4321. Open up your browser to http://localhost:4321 to view the site. As you make changes to the source files, Astro updates the site and forces a browser refresh.
1535

1636
## 🚀 Project Structure
1737

@@ -49,6 +69,6 @@ All commands are run from the root of the project, from a terminal:
4969
| `npm run astro ...` | Run CLI commands like `astro add`, `astro check` |
5070
| `npm run astro -- --help` | Get help using the Astro CLI |
5171

52-
## 👀 Want to learn more?
72+
## Thanks
5373

54-
Check out [Starlight’s docs](https://starlight.astro.build/), read [the Astro documentation](https://docs.astro.build), or jump into the [Astro Discord server](https://astro.build/chat).
74+
Gin thrives on community participation, and we really appreciate your contributions to our site and our documentation!

0 commit comments

Comments
 (0)