Vote up to Idea Be less surprising Vote down to Idea Be less surprising

Rank 28

Idea#144

This idea is active.
General Feedback »

Be less surprising

This ended up being much longer then I intended so I posted it as a gist over here https://gist.github.com/calvinmetcalf/5721819

tl;dr:

Don't be clever, take the conventions of other popular rest APIs as a guide, it's still better then 90% of government.

Comment

Submitted by 1 year ago

Comments (6)

  1. Moderator

    Calvin! I love you man. I admire your passion, but have you ever heard of a compliment sandwich? :D

    1 year ago
    1. calvin.metcalf Idea Submitter

      woops your right, fixed.

      1 year ago
  2. Moderator

    :D, now I'm concerned about your sincerity (jk) We'll take it!

    1 year ago
  3. the api is excellent as it is. the one thing it needs is dataset coverage expansion. this is a vote not to encumber the operation with metadata and seemingly helpful attributing or structural 'improvements.'

    1 year ago
    1. calvin.metcalf Idea Submitter

      True if it was an either or situation I'd probably take more data over API improvements, but at National Day of Civic Hacking we were informed we should give the API some 'tough love' about how it can be improved.

      1 year ago
  4. calvin.metcalf Idea Submitter

    When I was talking about json based documentation, this-> http://data-otp.rhcloud.com/docs/2011/acs5/ is what I had in mind.

    I made that for my own use browsing the data, it worked too I was able to find a LOT more interesting stuff.

    1 year ago

Vote Activity Show

Events

  1. The idea was posted
    1 year ago