Commit 2f2b382b authored by Adam Caprez's avatar Adam Caprez
Browse files

Merge branch 'contributing' into 'master'


See merge request hcc/hcc-docs!144
parents 0124bf3d 4707cba7
# Contributing
Our users have a wonderful perspective into our documentation that our staff do not.
It's easy for people who have been using it for a while
to forget how impenetrable some of this material can be. As such, we
greatly welcome feedback and contributions of all kinds:
suggested changes,
fixes to existing material,
and bug reports are all welcome.
## Contributor Agreement
By contributing,
you agree that we may redistribute your work under [our license](
## How to Contribute a Fix or Suggested Change
The easiest way to get started is to file an issue
to tell us about a spelling mistake,
some awkward wording,
or a factual error.
1. If you do not have access to [UNL's GitLab instance][],
you can [send us comments by email][contact].
we will be able to respond more quickly if you use one of the other methods described below.
2. If you have access to [UNL's GitLab instance][],
but do not know how to use Git,
you can report problems or suggest improvements by [creating an issue][issues].
This allows us to assign the item to someone
and to respond to it in a threaded discussion. Detailed information on creating
issues can be found in the [GitLab Documentation](
3. If you are comfortable with Git,
and would like to add or change material,
you can submit a pull request (PR).
Instructions for doing this are [included below](#using-gitlab).
## Where to Contribute
1. Checking for outstanding [issues](issues) is a quick way to identify contribution areas. Additionally,
review an comments on existing merge requests are welcome.
2. All documentation content can be found within the `content` folder. Subdirectories indicate menu items,
with the top level document called `` within each subdirectory.
Note: please do not submit modifications to theme or CSS items, `_header` or `_footer` files unless they
adhere to [UNL style guidelines](
## What to Contribute
There are many ways to contribute,
from contributing additional documentation topics or submitting software specific job examples,
to updating or adding to existing documentation and submitting [bug reports][issues]
about things that don't work, aren't clear, or are missing.
Comments on issues and reviews of pull requests are just as welcome:
we are smarter together than we are on our own.
Reviews from novices and newcomers are particularly valuable:
so fresh eyes are always welcome.
## Using GitLab
The best way to submit proposed changes is:
1. Create a fork of the HCC docs repository.
- [Documentation on how to fork a project](
2. Clone your forked repository and commit changes.
- [Details on setting up a Hugo environment on your personal machine](
3. Submit a merge request between your fork and the main HCC docs repository.
- [How to submit a merge request](
## Other Resources
If you have any questions or feedback, please contact us at
......@@ -3,3 +3,5 @@
{{< icon name="copyright-mark" >}} [Holland Computing Center] ( | 118 Schorr Center, Lincoln NE 68588 | {{< icon name="envelope" >}}[] ( | {{< icon name="phone-alt" >}}402-472-5041
See something wrong? Help us fix it by [contributing](!
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment