Update repo hooks documentation by elskwid · Pull Request #337 · github/developer.github.com · GitHub
Skip to content
This repository was archived by the owner on Nov 1, 2017. It is now read-only.

Update repo hooks documentation - #337

Merged
gjtorikian merged 3 commits into
github:masterfrom
elskwid:patch-1
Nov 6, 2013
Merged

Update repo hooks documentation#337
gjtorikian merged 3 commits into
github:masterfrom
elskwid:patch-1

Conversation

@elskwid

@elskwid elskwid commented Oct 22, 2013

Copy link
Copy Markdown
Contributor

I ran into some confusion over the weekend thinking that the web service should listen to all events by default. @kdaigle suggested that I update the docs, and so I have.

Clarify and expand hook documentation to explain the differences between a service and an event, each of which got a section header with links throughout. Provide details on service configuration settings, default events and supported events.

  • Increase heading levels to support new sections
  • Provide more linking throughout
  • Add examples in the service and event sections

Clarify and expand hook documentation to explain the differences between a `service` and an `event`, each of which got a section header with links throughout. Provide details on service configuration settings, default events and supported events.

* Increase heading levels to support new sections
* Provide more linking throughout
* Add examples in the service and event sections
@elskwid

elskwid commented Nov 5, 2013

Copy link
Copy Markdown
Contributor Author

@gjtorikian

Copy link
Copy Markdown
Contributor

@elskwid Thanks for the ping, I missed this the first time around.

At a cursory glance, it looks wonderful. I'll take a more in-depth look in a little bit, and probably provide comments.

@elskwid

elskwid commented Nov 5, 2013

Copy link
Copy Markdown
Contributor Author

@gjtorikian, fantastic! Please do let me know if you'd like me to make any changes.

Comment thread content/v3/repos/hooks.md Outdated

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

comma here, please: more [event](#events), regardless

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Hrm, as I'm reading this again should it be:

... can be configured for a specific service and one or more event ...
or
... can be configured for a specific service and one or more events ...

The second one sounds better to me.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Yep, events makes sense.

@gjtorikian

Copy link
Copy Markdown
Contributor

@elskwid Love it! Made a few pedantic comments but overall it's solid work. Thanks!

@elskwid

elskwid commented Nov 5, 2013

Copy link
Copy Markdown
Contributor Author

@gjtorikian - I'm on it.

@elskwid

elskwid commented Nov 6, 2013

Copy link
Copy Markdown
Contributor Author

@gjtorikian: Okay, I put that last question/comment in about the plural for events. Other than that, this is good to go.

Plurals are goods.
@elskwid

elskwid commented Nov 6, 2013

Copy link
Copy Markdown
Contributor Author

And there it is. Thanks again for all your help @gjtorikian.

@gjtorikian

Copy link
Copy Markdown
Contributor

What, no way, thank you. Mergin' it.

gjtorikian added a commit that referenced this pull request Nov 6, 2013
Update repo hooks documentation
@gjtorikian
gjtorikian merged commit 9cb8589 into github:master Nov 6, 2013
gjtorikian added a commit that referenced this pull request Nov 6, 2013
@elskwid

elskwid commented Nov 6, 2013

Copy link
Copy Markdown
Contributor Author

gjtorikian added a commit that referenced this pull request Nov 24, 2014
Update OAuth acceptance dialog
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants