Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 32 lines (21 sloc) 1.555 kb
b44768c @yrashk Added initial CONTRIBUTING.md
yrashk authored
1 CONTRIBUTING
2 ============
3
4 How can I suggest a new package?
5 --------------------------------
6
7 Just [open an issue](https://github.com/agner/agner/issues) with your suggestion.
8
9 How can I create a new package?
10 -------------------------------
11
12 You can create a spec repository by forking and renaming [template package repo](https://github.com/agner/agner.template)
13 and later on submitting it for inclusion by [opening an issue](https://github.com/agner/agner/issues).
14 The last step is only necessary if you want this package to be published on a "central" index.
15 If you want to keep it semi-private, you can just use it from your own index.
16
5010b7a @yrashk Added a little bit more information on tag shuffling to CONTRIBUTING.md
yrashk authored
17
18 Mastering specification
19 -----------------------
20
b2fcaa4 @yrashk Fixed broken link in README.md
yrashk authored
21 First of all, please take some time to read through [README](README.md) to make sure you understand all the concepts,
5010b7a @yrashk Added a little bit more information on tag shuffling to CONTRIBUTING.md
yrashk authored
22 especially how versioning is done.
23
24 Also, even though in Git world you can be crucified for deleting remote tags (`release` versions in our lingo), in Agner,
25 even not encouraged, this type of action is tolerable if you need to change the specification of an already published release.
26 `.agner` repos are intended for quick fresh cloning so shuffling tags in them is not that critical. If you do anticiapte anticipate that somebody has a fork of your `.agner` repo, though, please communicate your tag changes to them, just in case. One of
27 the ways might be adding some README or NOTES file into your `.agner` repo.
28
b44768c @yrashk Added initial CONTRIBUTING.md
yrashk authored
29 Before commiting your agner.config, please make sure you ran `agner verify` on it so it passes at least
5010b7a @yrashk Added a little bit more information on tag shuffling to CONTRIBUTING.md
yrashk authored
30 some validity checks.
31
Something went wrong with that request. Please try again.