Skip to content

Commit 8bee17d

Browse files
committed
docs: add contributing docs
1 parent b5d5767 commit 8bee17d

File tree

3 files changed

+40
-4
lines changed

3 files changed

+40
-4
lines changed

.github/workflows/nodejs.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ jobs:
3232
if [[ $GITHUB_REF == refs/tags/* ]]; then
3333
VERSION=${GITHUB_REF#refs/tags/v}
3434
fi
35-
TAGS="${DOCKER_IMAGE}:${VERSION},${DOCKER_IMAGE}:${SHORTREF}"
35+
TAGS="${DOCKER_IMAGE}:${VERSION}"
3636
3737
# If the VERSION looks like a version number, assume that
3838
# this is the most recent version of the image and also

CONTRIBUTING.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# Contributing
2+
3+
## Technological stack
4+
5+
The project uses the Nodejs runtime environment but aims to use minimal
6+
dependencies in order to create small bundle sizes.
7+
8+
## Git methodology
9+
10+
This project uses `main` as development branch. New features are committed
11+
through feature branches and merged into main through pull requests.
12+
13+
## Release management
14+
15+
This project uses [semver](https://semver.org/), handled by the NPM package
16+
[standard-version](https://www.npmjs.com/package/standard-version). For creating
17+
a new release, run the following commands:
18+
19+
```sh
20+
npm run release
21+
git push --follow-tags origin main
22+
```

README.md

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,9 @@
33
_This software has not been tested in regards of security and should not be used
44
in a production environment_
55

6-
**file-server-domain** is a simplistic Nodejs file server supporting multiple
7-
domains. It is mainly intended to run an internal network with its own DNS
8-
server.
6+
**file-domain-server** is a simplistic Nodejs HTTP file server that serve
7+
different folders depending on the HTTP `Host` header. It is mainly intended to
8+
run an internal network with its own DNS server.
99

1010
## Configuration
1111

@@ -29,6 +29,15 @@ build/mycat.com/index.html
2929
build/mycat.com/script.js
3030
```
3131

32+
### Environmental variables
33+
34+
The following can be configured as environment variables:
35+
36+
- **DEFAULT_INDEX_FILE** name of file served on paths ending with a trailing
37+
slash (default `index.html`).
38+
- **PORT** the port the server should listen on (default 8080).
39+
- **ROOT_FILE_PATH** root directory of served file tree (default `build`).
40+
3241
## Docker
3342

3443
The server can be run through Docker
@@ -41,3 +50,8 @@ docker run \
4150
--volume ${PWD}/build/:/app/build/ \
4251
johanbook/file-domain-server:latest
4352
```
53+
54+
## Contributing
55+
56+
For contributions and development procedures, see the
57+
[contributions file](./CONTRIBUTING.md).

0 commit comments

Comments
 (0)