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

Using GET makes tries bookmarkable and easier to share. #1

Merged
merged 1 commit into from Aug 28, 2013

Conversation

CharString
Copy link
Contributor

I want to use try.docopt.org in an online discussion about a CLI.

This makes examples easier to share.

And using POST was unnecessary:

  • there's no server state, so requests are always safe
  • every request with the same doc and argv should render the same response (unless after the event of a major docopt update), which makes them idempotent.

GET fits nicely.

POST isn't really needed here; there's no server state that changes.
Using GET makes it easy to share ideas for a CLI in discussions.
@keleshev
Copy link
Member

That's a nice idea, thanks! I can imagine pasting links to example here and there.

keleshev added a commit that referenced this pull request Aug 28, 2013
Using GET makes tries bookmarkable and easier to share.
@keleshev keleshev merged commit d8a5388 into docopt:master Aug 28, 2013
@CharString
Copy link
Contributor Author

Nice to see you pushed it live...

The GET also makes it caching proxy-friendly. Handy for when the docopt API hits 1.0.0 and the whole world will be using it and porting existing interfaces. ;-)

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

2 participants