Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add API section to README; add HACKING.md; remove Makefile #67

Merged
merged 6 commits into from Sep 15, 2021

Conversation

benhoyt
Copy link
Contributor

@benhoyt benhoyt commented Sep 15, 2021

  • A few additions to README.md, most notably adding a brief description of the API and its clients.
  • Adding a HACKING.md for developers to more easily get into the project.
  • Removing the Makefile: this was unnecessarily complex, unmaintained, and didn't work in some cases. Per discussion elsewhere, we're better off just sticking to the simple go commands the Pebble developers actually use (and which HACKING.md now details).

HACKING.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved

... and enjoy the rest of 2021!
We welcome quality external contributions. We have good unit tests for much of the code, and a thorough code review process. Please note that unless it's a trivial fix, it's generally worth opening an issue to discuss before submitting a pull request.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Probably mention Ubuntu CoC and how to sign the CoC https://help.ubuntu.com/community/SigningCodeofConduct

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure signing a CoC should be necessary for submitting a pull request. However, it looks like other Canonical projects (including snapd) require signing the Canonical Contributor License Agreement -- I'm guessing we probably want to do the same here, so I've added a link to that.

Copy link
Member

@jnsgruk jnsgruk left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice, thanks Ben.

@benhoyt
Copy link
Contributor Author

benhoyt commented Sep 15, 2021

@niemeyer These are just lightweight documentation changes (and I believe you were already in favour of getting rid of the Makefile), so I'll go ahead and merge -- we can easily tweak later as needed.

@benhoyt benhoyt merged commit 78ab29b into canonical:master Sep 15, 2021
@benhoyt benhoyt deleted the readme-updates branch September 15, 2021 21:43
benhoyt added a commit to benhoyt/juju that referenced this pull request Oct 1, 2021
More specifically, these PRs:

* canonical/pebble#59 Add GPLv3 license (to match source header and snapd)
* canonical/pebble#64 Avoid use of multipart.Part.FileName() to fix files API on Go 1.17
* canonical/pebble#63 Add wait-change API endpoint and client function
* canonical/pebble#65 Make Pebble "go vet" clean
* canonical/pebble#66 Remove a bunch of snapd references
* canonical/pebble#67 Add API section to README; add HACKING.md; remove Makefile
* canonical/pebble#60 Add Replan operation to restart changed services.
* canonical/pebble#61 One-shot commands (pebble exec)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants