Commit graph

26 commits

Author SHA1 Message Date
Valentin Rothberg 9d78203570 add a PR template
Add a pull-request template that points to the section in the
contributing guidelines and to remind users to use the `[CI:DOCS]`
prefix if applicable.

Signed-off-by: Valentin Rothberg <rothberg@redhat.com>
2020-11-04 11:02:37 +01:00
Chris Evich 611c0cb0e0
[CI:DOCS] Fix broken CI readme links
Signed-off-by: Chris Evich <cevich@redhat.com>
2020-10-30 10:32:17 -04:00
3sky e01eb92672 add prerequisite section before building binaries
Signed-off-by: 3sky <3sky@protonmail.com>
2020-10-07 21:57:47 +02:00
TomSweeneyRedHat 65878c48d7 [CI:DOCS] Add 'In Progress' note to CONTRIBUTING.md
Update the CONTRIBUTING.md to explain the use of the
new "In Progress" label in the Podman repository.
This emulates the verbiage in Buildah.

Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com>
2020-09-21 17:03:05 -04:00
Paul Holzinger 116300f968 [CI:DOCS] Switch more references from libpod to podman
Switch the libpod references to podman in the CONTRIBUTING.md.
Update the cirrus-ci link so we can get a green build again :)

Signed-off-by: Paul Holzinger <paul.holzinger@web.de>
2020-08-27 22:36:35 +02:00
Daniel J Walsh a5e37ad280
Switch all references to github.com/containers/libpod -> podman
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2020-07-28 08:23:45 -04:00
Chris Evich d0782e7839
Cirrus: Fix gate image & false-positive exits
A number of scripts relating to tooling used and the gate container
image were not exiting upon errors as intended.  Coupled with
external service unavailability (i.e. downloading golangci-lint)
was observed to cause difficult to debug failures.

This change corrects the scripts inside/out of the gate container as
well as fixes many golang related path consistency problems vs other CI
jobs.  After this change, all jobs use consistent path names reducing
the number of special-case overrides needed.

Lastly, I also made a documentation-pass, updating/correcting as needed,
including documenting a likely local validation-failure mode, related to
`$EPOCH_TEST_COMMIT`.  This is dependent on the developers git
environment, so documentation is the only possible "fix".

Signed-off-by: Chris Evich <cevich@redhat.com>
2020-03-02 08:50:54 -05:00
Valentin Rothberg d038e6a5ff drop OWNERS link for CONTRIBUTING.md
It was pointing to K8s docs and didn't really fit into the
communications context.

Signed-off-by: Valentin Rothberg <rothberg@redhat.com>
2019-09-25 13:49:18 +02:00
Daniel J Walsh 369f8b8862
Fix spelling mistakes in man pages and other docs
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2019-07-11 17:56:54 -04:00
Valentin Rothberg 2d1e52d3e9 CONTRIBUTING.md: fix project paths
The paths to the local libpod tree where missing the `./src` part which
ultimately lead to compilation errors.  Also place the git trees into
containers/libpod and not into the user's GitHub root.

Reported in #podman on IRC.
Signed-off-by: Valentin Rothberg <rothberg@redhat.com>
2019-07-08 14:25:51 +02:00
Petr Vaněk d1326a89a8 CONTRIBUTING.md: fix typo
Signed-off-by: Petr Vaněk <arkamar@atlas.cz>
2019-06-15 23:05:02 +02:00
Matthew Heon a5995e0473 Mention the new Podman mailing list in contributing.md
Signed-off-by: Matthew Heon <matthew.heon@pm.me>
2019-06-13 12:51:39 -04:00
Chris Evich 5369e45470
docs: Add CI section and links
Signed-off-by: Chris Evich <cevich@redhat.com>
2019-05-30 12:55:51 -04:00
Chris Evich 711c056971
[ci skip] Critical note about merge bot
Signed-off-by: Chris Evich <cevich@redhat.com>
2019-02-28 10:01:29 -05:00
Hervé Beraud 0463334579 Introduce how to start to hack on libpod.
Introduce a new part inside the contribution guide
who explain how to start to hack on libpod:
- setup environment
- install tools
- using make
- building podman
- test your changes locally

Signed-off-by: Hervé Beraud <hberaud@redhat.com>
2019-02-22 17:12:18 +01:00
Chris Evich 4606ca8fa6
[skip ci] Docs: Add Bot Interactions section
Signed-off-by: Chris Evich <cevich@redhat.com>
2019-01-04 14:51:20 -05:00
Chris Evich 7a0005bd2d
[skip ci] Gate: Update docs w/ safer local command
Previously if you used the documented code validation command,
you would end up with your repository SELinux labels being changed.  In
many cases this is not desirable.  Update the documentation such that
the original source of the repository isn't touched in any way (prior
to making a copy of it in the container).

Also add a small (but important) note about building the container
image.

Signed-off-by: Chris Evich <cevich@redhat.com>
2018-12-19 14:28:32 -05:00
Chris Evich 86d1196f9b
Standardized container image for gofmt and lint
Having a standardized image allows uniform application of format and
lint checking across multiple host platforms.  This ensures all
contributors and disparate CI systems to play by a common set of basic
rules.  It also makes it easier to maintain the common rules over-time.

Signed-off-by: Chris Evich <cevich@redhat.com>
2018-11-13 07:55:07 -05:00
Valentin Rothberg a36974585f CONTRIBUTING.md: add section about describing changes
Add a section about describing changes in commit messages.  GitHub tends
to drive the large part of discussions and change descriptions to the
corresponding pull requests and issues, but such information is lost in
the git history.  Not providing sufficient information in commit
messages is painful for reviewing and can cause issues while debugging.
It also complicates studying source code, where reading commit messages
and the code's git history is a common approach to better understand the
code.

Following the descriptions should be enforced by the maintainers of the
libpod project.  Pull requests containing commits without proper
descriptions should not be merged.

This change bases on the documentation of the Linux kernel v4.17:
https://www.kernel.org/doc/html/v4.17/process/submitting-patches.html

Signed-off-by: Valentin Rothberg <vrothberg@suse.com>
2018-10-29 13:13:34 +01:00
Daniel J Walsh d20f3a5146 switch projectatomic to containers
Need to get some small changes into libpod to pull back into buildah
to complete buildah transition.

Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>

Closes: #1270
Approved by: mheon
2018-08-16 17:12:36 +00:00
TomSweeneyRedHat 781eec27b5 Add pointers for Integration Tests to docs
Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com>

Closes: #910
Approved by: rhatdan
2018-06-06 18:45:57 +00:00
W. Trevor King eda0fd7468 CONTRIBUTING: Document PR approval and link to OWNERS
Remove a dead "Becoming a Maintainer" link and that stub section,
since libpod currently doesn't document that process.  By leaving it
undocumented, maintainer changes falls back to the usual pull-request
review process.

Signed-off-by: W. Trevor King <wking@tremily.us>

Closes: #688
Approved by: rhatdan
2018-04-28 07:45:30 +00:00
W. Trevor King 4e468ce83d README: Link to CONTRIBUTING.md
Make that information more easily discoverable.  And since
CONTRIBUTING.md already mentions IRC, we can drop the IRC reference
from the README to DRY things up.

Also update CONTRIBUTING.md to replace the stale #cri-o reference left
over from the initial libpod/podman fork.  While I was touching this
line, I also shuffled some of the wording around to tighten that
sentence up.

Signed-off-by: W. Trevor King <wking@tremily.us>

Closes: #687
Approved by: rhatdan
2018-04-27 19:05:46 +00:00
Daniel J Walsh 099b5fb6f6 Ran spell checker through all man pages
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>

Closes: #269
Approved by: TomSweeneyRedHat
2018-01-29 15:21:34 +00:00
Matthew Heon c13f61798a Prune Server package. Convert to new github location.
Signed-off-by: Matthew Heon <matthew.heon@gmail.com>
2017-11-01 13:22:04 -04:00
Matthew Heon a031b83a09 Initial checkin from CRI-O repo
Signed-off-by: Matthew Heon <matthew.heon@gmail.com>
2017-11-01 11:24:59 -04:00