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

Expand route documentation in the README #1923

Merged
merged 2 commits into from
Nov 5, 2019

Conversation

wdspkr
Copy link
Contributor

@wdspkr wdspkr commented Oct 25, 2019

This adds some more documentation, that was partly implicitly covered
by the Basic Usage example but partly was only to be got by the method
documentation. As this is an essential part of the DSL this it added for
the new users conveniance. At least I was missing the info.

This is my first draft, so please tell me whether I'm missing something, or got something wrong!

This adds some more documentation, that was partly implicitly covered
by the Basic Usage example but partly was only to be got by the method
documentation. As this is an essential part of the DSL this it added for
the new users conveniance.
@grape-bot
Copy link

grape-bot commented Oct 25, 2019

1 Warning
⚠️ Unless you’re refactoring existing code, please update CHANGELOG.md.

Here's an example of a CHANGELOG.md entry:

* [#1923](https://github.com/ruby-grape/grape/pull/1923): Expand route documentation in the readme - [@wdspkr](https://github.com/wdspkr).

Generated by 🚫 danger

@wdspkr wdspkr closed this Oct 25, 2019
@wdspkr wdspkr reopened this Oct 25, 2019
@dblock
Copy link
Member

dblock commented Oct 25, 2019

Don't worry about danger.

@wdspkr
Copy link
Contributor Author

wdspkr commented Oct 25, 2019

Sorry, misclicked. 😄

README.md Outdated
get 'status' do
end

# is the same as (!)
Copy link
Member

Choose a reason for hiding this comment

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

What's ! here?

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 wanted to somehow raise attention that this will not result in a route parameter. But that was probably too subtle so I now extended the example.
Is this better now?

@dblock dblock merged commit 3f9bcf9 into ruby-grape:master Nov 5, 2019
@dblock
Copy link
Member

dblock commented Nov 5, 2019

LGTM, merged

basjanssen pushed a commit to basjanssen/grape that referenced this pull request Feb 28, 2020
This adds some more documentation, that was partly implicitly covered
by the Basic Usage example but partly was only to be got by the method
documentation. As this is an essential part of the DSL this it added for
the new users convenience.
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.

3 participants