Skip to content

Commit

Permalink
Added Contributing Guidelines
Browse files Browse the repository at this point in the history
  • Loading branch information
b01 committed May 9, 2024
1 parent 03b0084 commit 0465ec3
Show file tree
Hide file tree
Showing 2 changed files with 82 additions and 4 deletions.
80 changes: 80 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
# Contributing Guidelines

This repository automatically releases when an approved PR is merged. So please
adhere to these rules for a smooth fast PR approval.

**Rules**S

* follow the [Commit Message Format] described here. These commits will appear
in the changelog and MUST be comprehensible by humans.
* provide test where possible to ensure this continue to work.
* rebase your branch with latest `main` trunk as often as needed.

### Commit Message Format

Each commit message consists of a **header**, a **body** and a **footer**. The
header has a special format that includes a **type**, a **scope** and a
**subject**:

```
<type>(<scope>): <subject>
<BLANK LINE>
<body>
<BLANK LINE>
<footer>
```

The **header** is mandatory and the **scope** of the header is optional.

Example — `fix: Error When Downloading VS Code Server`

Any line of the commit message cannot be longer 100 characters. This allows the
message to be easier to read on GitHub as well as in various git tools.

#### Type

Must be one of the following:

* **feat**: A new feature.
* **fix**: A bug fix.
* **docs**: Documentation only changes.
* **style**: Changes that do not affect the meaning of the code (white-space,
formatting, missing semi-colons, etc).
* **refactor**: A code change that neither fixes a bug nor adds a feature.
* **perf**: A code change that improves performance.
* **test**: Adding missing tests.
* **chore**: Changes to the build process or auxiliary tools and libraries such
as documentation generation.

#### Scope

The scope is optional and could be anything specifying place of the commit
change. For example `win32`, `mac`, `linux`, etc...

#### Subject

The subject contains succinct description of the change:

* use the past tense: `changed` or `changes` not `change` since the commit
should accomplish what is described,
* Capitalize letters as you would in a header,
* no punctuation at the end.

#### Body

Briefly describe what the commit accomplishes, it should be done, so you past
tense, "changed" not "changes" not "change" as if your going to do it.

#### Footer

The footer should contain any information about **Breaking Changes** and is
also the place to reference GitHub issues that this commit **Closes**.


**Breaking Changes** should start with the word `BREAKING CHANGE:` with a
space or two newlines. The rest of the commit message is then used for this.

This document is based on [Conventional Commits].

[Conventional Commits]: https://www.conventionalcommits.org/en/v1.0.0/
[Commit Message Format]: #commit-message-format
6 changes: 2 additions & 4 deletions test/alpine-musl/Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -40,18 +40,16 @@ RUN addgroup --system --gid ${USER_GID} ${USER_GROUP} \

USER ${USER_NAME}

COPY --chmod=${USER_NAME}:${USER_NAME} test/alpine/start.sh /usr/local/bin
COPY --chown=${USER_NAME}:${USER_NAME} test/alpine/start.sh /usr/local/bin

HEALTHCHECK --interval=5m --timeout=3s \
CMD echo "healthy" || exit 1

ENTRYPOINT [ "start.sh" ]

COPY --chmod=${USER_NAME}:${USER_NAME} download-vs-code-server.sh /tmp
COPY --chmod=${USER_NAME}:${USER_NAME} setup-server-via-vs-code-cli.sh /tmp
COPY --chown=${USER_NAME}:${USER_NAME} --chmod=777 download-vs-code-server.sh /tmp

# Install VS Code Server
RUN /tmp/download-vs-code-server.sh "linux" "alpine" "yes"
RUN /tmp/setup-server-via-vs-code-cli.sh "alpine" "x64" "yes"

WORKDIR ${WD}

0 comments on commit 0465ec3

Please sign in to comment.