Skip to content

Commit bc8c301

Browse files
committed
docs: Writes a readme
1 parent 779f5c4 commit bc8c301

File tree

1 file changed

+100
-3
lines changed

1 file changed

+100
-3
lines changed

.github/README.md

+100-3
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,111 @@
55
> This is a very early work in progress, and is not yet feature complete or production ready.
66
> Stay tuned!
77
8-
### Start Server
8+
---
99

10+
## Usage
11+
12+
### Developing
13+
14+
#### Getting Started
15+
16+
You will need [git](https://git-scm.com/) and [go](https://go.dev/) installed.
17+
Then clone the repo and download dependencies.
18+
19+
```bash
20+
git clone git@github.com:xray-web/web-check-api.git
21+
cd web-check-api
22+
go mod download
1023
```
24+
25+
#### Start Server
26+
27+
```bash
1128
make run
1229
```
1330

14-
### Run Tests
31+
#### Run Tests
1532

16-
```
33+
```bash
1734
make test
1835
```
36+
37+
38+
### Deploying
39+
40+
#### Option 1: From Source
41+
42+
Follow the setup instructions above. Then build the binaries.
43+
Then execute the output executable directly (e.g. `./bin/app`)
44+
45+
```bash
46+
make build
47+
```
48+
49+
#### Option 2: From Docker
50+
51+
```
52+
docker run -p 8080:8080 lissy93/web-check-api
53+
```
54+
55+
#### Option 3: Download Executable
56+
From the releases tab, download the compiled binary for your system, and execute it.
57+
58+
---
59+
60+
## License
61+
62+
> _**[Web Check](https://github.com/Lissy93/web-check)** is licensed under [MIT](https://github.com/xray-web/web-check-api/blob/HEAD/LICENSE) © [Alicia Sykes](https://aliciasykes.com) 2024._<br>
63+
> <sup align="right">For information, see <a href="https://tldrlegal.com/license/mit-license">TLDR Legal > MIT</a></sup>
64+
65+
<details>
66+
<summary>Expand License</summary>
67+
68+
```
69+
The MIT License (MIT)
70+
Copyright (c) Alicia Sykes <alicia@omg.com>
71+
72+
Permission is hereby granted, free of charge, to any person obtaining a copy
73+
of this software and associated documentation files (the "Software"), to deal
74+
in the Software without restriction, including without limitation the rights
75+
to use, copy, modify, merge, publish, distribute, sub-license, and/or sell
76+
copies of the Software, and to permit persons to whom the Software is furnished
77+
to do so, subject to the following conditions:
78+
79+
The above copyright notice and this permission notice shall be included install
80+
copies or substantial portions of the Software.
81+
82+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
83+
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANT ABILITY, FITNESS FOR A
84+
PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
85+
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
86+
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
87+
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
88+
```
89+
90+
</details>
91+
92+
93+
<!-- License + Copyright -->
94+
<p align="center">
95+
<i>© <a href="https://aliciasykes.com">Alicia Sykes</a> 2024</i><br>
96+
<i>Licensed under <a href="https://gist.github.com/Lissy93/143d2ee01ccc5c052a17">MIT</a></i><br>
97+
<a href="https://github.com/lissy93"><img src="https://i.ibb.co/4KtpYxb/octocat-clean-mini.png" /></a><br>
98+
<sup>Thanks for visiting :)</sup>
99+
</p>
100+
101+
<!-- Dinosaurs are Awesome -->
102+
<!--
103+
. - ~ ~ ~ - .
104+
.. _ .-~ ~-.
105+
//| \ `..~ `.
106+
|| | } } / \ \
107+
(\ \\ \~^..' | } \
108+
\`.-~ o / } | / \
109+
(__ | / | / `.
110+
`- - ~ ~ -._| /_ - ~ ~ ^| /- _ `.
111+
| / | / ~-. ~- _
112+
|_____| |_____| ~ - . _ _~_-_
113+
-->
114+
115+

0 commit comments

Comments
 (0)