mirror of
https://codeberg.org/andyscott/ziglings.git
synced 2024-11-08 11:20:46 -05:00
Adding CONTRIBUTING (#42)
This commit is contained in:
parent
54f2ace51a
commit
a926f9f893
1 changed files with 79 additions and 0 deletions
79
CONTRIBUTING.md
Normal file
79
CONTRIBUTING.md
Normal file
|
@ -0,0 +1,79 @@
|
|||
# Contributing
|
||||
|
||||
By reading this document, you have already entered the Elite Hall of Ziglings
|
||||
Maintenance!
|
||||
|
||||
|
||||
## The Ziglings Audience
|
||||
|
||||
Ziglings is is intended for programmers of all experience levels. No specific
|
||||
language knowledge is expected. If you can install the current Zig snapshot,
|
||||
setup a copy of Ziglings, and understand if/then/else, loops, and functions,
|
||||
then you're ready.
|
||||
|
||||
Experience with strong typing, manual memory management, and certain language
|
||||
constructs and idioms will greatly increase the speed at which you'll be able
|
||||
to tackle each exercise. But speed isn't important, only learning is important.
|
||||
|
||||
Ziglings is intended to be completely self-contained. If you can't solve an
|
||||
exercise from the information you've gleaned so far from Ziglings, then the
|
||||
exercise probably needs some additional work. Please file an issue!
|
||||
|
||||
If an example doesn't match a description or if something is unclear, please
|
||||
file an issue!
|
||||
|
||||
|
||||
## Spelling/Grammar
|
||||
|
||||
If you see any typos, please file an issue or make a pull request.
|
||||
|
||||
No mistake is too small. The Ziglings must be perfect.
|
||||
|
||||
|
||||
## Ideas
|
||||
|
||||
If you have ideas for new lessons or a way Ziglings could be improved, don't
|
||||
hesitate to file an issue.
|
||||
|
||||
I prefer to actually write all of the content myself at this time (part of the
|
||||
reason I'm building Ziglings is to learn Zig myself!), but I'm always open to
|
||||
ideas.
|
||||
|
||||
|
||||
## Platforms and Zig Versions
|
||||
|
||||
Because it uses the Zig build system, Ziglings should work wherever Zig does.
|
||||
|
||||
Since Ziglings is a Zig language learning resource, it tracks the current
|
||||
development of Zig.
|
||||
|
||||
If you run into an error in Ziglings due to language changes (and you have the
|
||||
latest development build of Zig and the latest commit to Ziglings), that's a
|
||||
bug! Please file an issue.
|
||||
|
||||
|
||||
## Formatting
|
||||
|
||||
All exercises are (or should be) formatted with `zig fmt`.
|
||||
|
||||
|
||||
## Pull Request Workflow
|
||||
|
||||
Ziglings uses the "standard" Github workflow as guided by the Web interface.
|
||||
Specifically:
|
||||
|
||||
* Fork this repository
|
||||
* Create a branch from `main` for your work: `git checkout -b my-branch`
|
||||
* Make changes, commit them
|
||||
* When your changes are ready for review, push your branch: `git push origin
|
||||
my-branch`
|
||||
* Create a pull request from your branch to `ziglings/main`
|
||||
* Your faithful Ziglings maintainer "ratfactor" (that's me!) will take a look
|
||||
at your request ASAP
|
||||
* Once the changes are reviewed, your request will be merged and eternal
|
||||
Ziglings contributor glory is yours!
|
||||
|
||||
|
||||
## The Secrets
|
||||
|
||||
If you want to peek at the secrets, take a look at the `patches/` directory.
|
Loading…
Reference in a new issue