Reflections on the REST Architectural Style and "Principled Design of the Modern Web Architecture"
"Seventeen years after its initial publication at ICSE 2000, the Representational State Transfer (REST) architectural style continues to hold significance as both a guide for understanding how the World Wide Web is designed to work and an example of how principled design, through the application of architectural styles, can impact the development and understanding of large-scale software architecture. However, REST has also become an industry buzzword: frequently abused to suit a particular argument, confused with the general notion of using HTTP, and denigrated for not being more like a programming methodology or implementation framework. In this paper, we chart the history, evolution, and shortcomings of REST, as well as several related architectural styles that it inspired, from the perspective of a chain of doctoral dissertations produced by the University of California's Institute for Software Research at UC Irvine. These successive theses share a common theme: extending the insights of REST to new domains and, in their own way, exploring the boundary of software engineering as it applies to decentralized software architectures and architectural design. We conclude with discussion of the circumstances, environment, and organizational characteristics that gave rise to this body of work."
rest  papers  design  apis 
8 days ago
Add Oauth1 to Security Scheme Object by starfishmod · Pull Request #1080 · OAI/OpenAPI-Specification
If all you need to do advertise that the API is using OAuth1 then just add this security scheme.

"type": "http",
"scheme": "oauth"
security  openapi  authentication 
13 days ago
REST API Notes for 2017/09/05 - GraphQL (again)
"A team recently submitted their API intent, in OAS compliant form, for review. In the place of detailed documentation about business objectives, endpoints, status codes, and payload, however, there was a single POST. In the POST body was a single parameter, named "query", defined as a "string" type. When questioned, the submitters stated that they were "doing GraphQL". Why GraphQL? Because it was "taking over" and they didn't want to be "left behind".

This is frustrating on a number of levels. As I tweeted, "FOMO is NOT ARCHITECTURAL GUIDANCE". Further, they failed to make a rational argument why this was the best approach for their unique problem (or, more importantly, how they will overcome the downsides of the trade off they're proposing)."
graphql  apis  design  styles 
14 days ago
Reflections on the REST Architectural Style and “Principled Design of the Modern Web Architecture” (Impact Paper Award)
"This suggests that the benefits of REST may be difficult to realize
unless the individual web participants align their internal architectures
to accommodate both asynchronous communications and
concurrent computations."
rest  clients  paper 
15 days ago
A Tale of Four API Designs: Dissecting Common API Architectures | Nordic APIs |
URI, hypermedia, event-driven, and tunneling

interesting breakdown
apis  design  styles 
21 days ago
The Marketing Behind MongoDB
"By mid-2012, there were more than 50 MongoDB user groups around the world that met regularly, built with 10gen's financial, marketing, and logistics support:

Investing in leaders is … an economical marketing tactic [for 10gen]. You can invest a small amount in developing a community leader, and expect a potentially large return from that investment. The most obvious example here is the MongoDB User Group network.

With $50,000, we could effectively support 13 user groups with some cash to spare… Our $50,000 investment has reached and engaged 3,900 members of the community across 13 different cities, with each group meeting monthly to discuss our technology.

At 10gen, we initially invest a lot of time and money into our user group organizers… The user group leaders build a network of speakers and they identify local companies to sponsor their events. The small investment continues to grow into a large, sustainable user group, often with many more than 300 members. We can then shift our attention and resources to developing user groups in new cities."
marketing  mongo  mongodb  developers  advocacy 
23 days ago
(3) Who are the best product managers to follow on Twitter? - Quora
"To make this list, each user had to be active (but not too active) and mostly tweet about product stuff. It includes not just PMs, but founders, designers or anyone else offering product insights

Here are my favorites, in no particular order (so read to the end ;)
Updated on 10/15/15

Hunter Walk (hunterwalk)
Ryan Hoover (rrhoover)
Josh Elman (joshelman)
Ryan Singer (rjs)
Expa (expa)
Jason Evanish (Evanish)
Sean Rose (@sean_a_rose)
Kenton Kivestu (kivestu)
Ben Chestnut (benchestnut)
Ian McAllister (ianmcall)
Joe Zadeh (joebot)
Pete Davies (pdavies)
Dan Olsen (danolsen)
Matt Schlicht (MattPRD)
Ariel Seidman (aseidman)
Ken Norton (kennethn)
Sachin Rekhi (sachinrekhi)
Julie Zhuo (joulee)
Braden Kowitz (kowitz)
Chris Dixon (cdixon)
Matte Scheinker (matte)
Andrew Chen (andrewchen)
Luke Wroblewski (lukew)
dustin curtis (dcurtis)
Kevin Rose (kevinrose)
Jason Shellen (shellen)
Intercom (intercom)
Sriram Krishnan (sriramk)
Michael S Galpert (msg)
Delighted (delighted)
Rebekah Cox (artypapers)
Jong-Moon Kim (jiggityk)
Ellen Chisa (ellenchisa)
David Sacks (DavidSacks)
Brian Lovin (brian_lovin)
Garrett Camp (gmc)
Bo Ren (Bosefina)
Paul Adams (Padday)
James Butts (jamesmakeseyes)
Sam Gerstenzang (gerstenzang)
Ernest Kim (edotkim)
Kenneth Berger (kberger)
Arjun Sethi (arjunsethi)
Bill Morein (wmorein)

and I try to tweet about product stuff myself as @kaz."
productmanagement  twitter  lists 
23 days ago
Virginia McIlhenny Obituary - New Orleans, LA | The Times-Picayune
"Virginia Smart McIlhenny, beloved member of the New Orleans community, died at home on August 19th with loving family at her side. She was born in 1925, the daughter of Anne Buchanan Smart and Robert Smart. She graduated from The Louise S. McGehee school and attended Newcomb College. In 1944, she married Edmund McIlhenny, who predeceased her in 1991. Mrs. McIlhenny spent her life in service to her family and friends and to her community. She served as member and president of the Junior League of New Orleans and the Garden Study Club. She was the founder and board president of the Nursery School for Preschool Blind Children, the president of the board of the Cottage School for hearing-impaired children, and president of the board of the Protestant Children's Home, president of the Parents' League of The Louise S. McGehee School, and on served on the boards of Newman School, and other civic, educational, and social organizations. In addition to her husband, Mrs. McIlhenny was predeceased by her sister Elizabeth Smart Schneidau. She is survived by her children: Edmund McIlhenny (Pam); Anne McIlhenny Gardiner (Robert); Louise Westfeldt McIlhenny (Hugh Riddleberger); Chaffe McIlhenny (Bonnie), and grandchildren: Cassie McIlhenny Ojeda (Rick); Virginia Nugent (John); Mary Eliza Ankenbauer (Stephen); Marsh Gardiner (Teressa); Avery Weld Gardiner; Katharine M. G. Tucker (Scott); Elizabeth H. G. Webster (Cliff); Emily M. R. Blackwell (Scott); Sarah M. R. Jones (Chandler); James M. Riddleberger; Matthew H. McIlhenny; Ethan H. McIlhenny (Carrie); and 19 great-grandchildren, and many nieces and nephews. The family wishes to thank Dr. Robert Miles, who cared for Virginia so lovingly and so well, and also the nurses and staff of Mercer's Way Lambeth House for their warmth and professionalism. Services will be held at Trinity Church at 10 AM on Tuesday, August 22, with visitation at the church beginning at 9 AM. In lieu of flowers, contributions may be made to The Louisiana Children's Museum, The Louise S. McGehee School, or Lambeth House."
family  obituary  granny 
26 days ago
meta: vote regarding Rod's status on the TSC · Issue #310 · nodejs/TSC
"A few weeks ago, concerns were raised by several TSC and CTC members regarding issues they had with @rvagg's interactions in the Github tracker and Twitter.

The specific issues that were reported include:

[Note: the specific list of issues has been removed at the request of several core collaborators who felt that listing the issues was not fair to Rod. This post was made with an effort at full transparency and with no ill intent towards anyone. No additional harm was intended by listing the issues - jasnell]

In light of the complaints, the TSC discussed these issues and discussed whether to take action against Rod regarding these issues. A specific question was raised whether Rod should be removed from the TSC.

Per the Charter, an individual TSC member may be removed only "by voluntary resignation, by a standard TSC motion, or in accordance to the participation rules".

The TSC members were not able to reach a natural consensus on the steps forward so a vote was called on two specific questions:

(A) Should Rod be removed from the TSC: Yes or No
(B) Should Rod be asked to voluntarily resign from the TSC: Yes or No"
governance  opensource  node  conflict  nodejs 
27 days ago
APIs as infrastructure: future-proofing Stripe with versioning
"At Stripe, we implement versioning with rolling versions that are named with the date they’re released (for example, 2017-05-24). Although backwards-incompatible, each one contains a small set of changes that make incremental upgrades relatively easy so that integrations can stay current.

The first time a user makes an API request, their account is automatically pinned to the most recent version available, and from then on, every API call they make is assigned that version implicitly. This approach guarantees that users don’t accidentally receive a breaking change and makes initial integration less painful by reducing the amount of necessary configuration. Users can override the version of any single request by manually setting the Stripe-Version header, or upgrade their account’s pinned version from Stripe’s dashboard.

Some readers might have already noticed that the Stripe API also defines major versions using a prefixed path (like /v1/charges). Although we reserve the right to make use of this at some point, it’s not likely to change for some time. As noted above, major version changes tend to make upgrades painful, and it’s hard for us to imagine an API redesign that’s important enough to justify this level of user impact. Our current approach has been sufficient for almost a hundred backwards-incompatible upgrades over the past six years."
apis  versioning  stripe  design 
5 weeks ago
I say Goodbye to Swagger, SmartBear, OpenAPI! What's next? | LinkedIn
"But there is this saying, that is people don't really try to screw you if you're not relevant. So as we were gaining relevance, there were some really disappointing, jaw-dropping jack-ass moves against the Swagger Project, and while I won't name people or companies here, it was painful to go through, and frankly I'm still pissed off about it. I learned some lessons around who to trust and how much, as getting stabbed in the back is a real bummer."
tony  apis  swagger  openapi  smartbear 
5 weeks ago
Indeterminacy of translation - Wikipedia
"The indeterminacy of translation is a thesis propounded by 20th-century American analytic philosopher W. V. Quine. The classic statement of this thesis can be found in his 1960 book Word and Object, which gathered together and refined much of Quine's previous work on subjects other than formal logic and set theory.[1] The indeterminacy of translation is also discussed at length in his Ontological Relativity.[2] Wright suggests that this "has been among the most widely discussed and controversial theses in modern analytical philosophy".[3] This view is endorsed by Putnam who states that it is "the most fascinating and the most discussed philosophical argument since Kant’s Transcendental Deduction of the Categories”.[4]

Three aspects of indeterminacy arise, of which two relate to indeterminacy of translation.[5] The three indeterminacies are (i) inscrutability of reference, and (ii) holophrastic indeterminacy, and (iii) the underdetermination of scientific theory. The last of these, not discussed here, refers to Quine's assessment that evidence alone does not dictate the choice of a scientific theory. The first refers to indeterminacy in interpreting individual words or sub-sentences. The second refers to indeterminacy in entire sentences or more extensive portions of discourse."
language  translation  words  philosophy 
5 weeks ago
Monitor Stack Overflow activity directly into Slack
"I hacked together something for our team at 3scale a long time ago. I recently rewrote it using serverless technologies.
It monitors questions about 3scale and posts them on our #support Slack channel, where the support team can jump on it and answer quickly.
I wanted to share this project, so you also can easily monitor Stack Overflow directly in Slack."
community  slack  tools  serverless 
6 weeks ago
#GTMtips: Undefined Dimensions Won't Get Sent - Simo Ahava's blog
"This might not sound like a tip to you. You might think, “Dimensions won’t get sent? Sounds like a bug!”. You’re wrong. This is one of the awesome features of the GA API, and it’s key to making your tag setups leaner when sending data to Google Analytics.

Tip 4: Undefined dimensions are left out of GA hits

Note that ‘undefined’ here means the special value undefined in JavaScript. For a refresher, check this post. If you use a macro in a dimension field of Google Tag Manager’s Universal Analytics tags, this dimension will be left out of the hit payload if its return value is undefined.

The hit itself will get sent, but the dimension will just be dropped out.

How is this awesome? Well, you might have thought until now that you need two tags for each version of the dimension reference: one for when it has a value, and one when its value is undefined. The latter version doesn’t have the dimension field populated at all.

You don’t have to go through this duplication of tags if you learn to use the power of undefined in your GTM macros. Just make sure the value is really undefined and not 'undefined', which is a String.

It’s not just Custom Dimensions this works with. Any fields that are translated into dimensions behave the same way, meaning you can use this to send pretty darn efficient virtual pageviews as well, as they use the Document Path field in your tags."
Google:tagmanager  dimensions  google:analytics 
6 weeks ago
How the Web Became Unreadable | WIRED

It’s been getting harder for me to read things on my phone and my laptop. I’ve caught myself squinting and holding the screen closer to my face. I’ve worried that my eyesight is starting to go. These hurdles have made me grumpier over time, but what pushed me over the edge was when Google’s App Engine console — a page that, as a developer, I use daily — changed its text from legible to illegible. Text that was once crisp and dark was suddenly lightened to a pallid gray. Though age has indeed taken its toll on my eyesight, it turns out that I was suffering from a design trend.
There’s a widespread movement in design circles to reduce the contrast between text and background, making type harder to read. Apple is guilty. Google is, too. So is Twitter.
Typography may not seem like a crucial design element, but it is. One of the reasons the web has become the default way that we access information is that it makes that information broadly available to everyone. “The power of the Web is in its universality,” wrote Tim Berners-Lee, director of the World Wide Web consortium. “Access by everyone regardless of disability is an essential aspect.”"
design  readability  wired  trends  criticism 
6 weeks ago
oauth - How to persist an OAuth2 token (or use a refresh token) in Postman collections? - Stack Overflow
"Be able to run a collection without going through the authorization process of every call individually prior to running the collection."
tips  postman  oauth  tokens 
6 weeks ago
Domain-driven design - Wikipedia
"Domain-driven design (DDD) is an approach to software development for complex needs by connecting the implementation to an evolving model.[1] The premise of domain-driven design is the following:
placing the project's primary focus on the core domain and domain logic;
basing complex designs on a model of the domain;
initiating a creative collaboration between technical and domain experts to iteratively refine a conceptual model that addresses particular domain problems."
design  development  domains  domain 
6 weeks ago
Analytics API Reference | Keen IO
"Saved queries allow you to easily access your favorite metrics. Rather than entering the same query parameters over and over again, queries can be easily saved, edited, and shared with your teammates."
apis  patterns  queries  keen  metrics  analytics 
6 weeks ago
The Greatest Sales Deck I’ve Ever Seen – The Mission – Medium
"The Greatest Sales Deck I’ve Ever Seen
It’s Zuora’s, and it’s brilliant. Here’s why.

A few months ago, my friend Tim took a new sales job at a Series C tech company that had raised over $60 million from A-list investors. He’s one of the best salespeople I know, but soon after starting, he emailed me to say he was struggling.
“I’ve landed a few small accounts,” Tim said. “But my pitch falls flat at big enterprises.”
As I’ve written before, I love helping teams craft the high-level strategic story that powers sales, marketing, fundraising — everything. So Tim and I met for lunch at the Amber India restaurant off San Francisco’s Market Street to review his deck.
After loading up on the all-you-can-eat buffet, I asked Tim, “At what point do prospects tune out?”
“Usually a few slides in,” he said.
Intent on maximizing dining ROI, Tim went back to the buffet for seconds. When he returned, I pulled out my laptop and launched into a Powerpoint presentation.
“What’s this?” Tim asked.
“This,” I said, “is the greatest sales deck I have ever seen.”
The 5 Elements of a Brilliant Sales Narrative"
marketing  sales  presentations  pitch  pitching  slides  deck 
6 weeks ago
The IT Era and the Internet Revolution – Stratechery by Ben Thompson
"I like to say that I write about media generally and journalism specifically because the industry is a canary in the coal mine when it comes to the impact of the Internet: text shifted from newsprint to the web seamlessly, completely upending the industry’s business model along the way.

Of course I have a vested interest in this shift: for better or worse I, by virtue of making my living on Stratechery, am a member of the media, and it would be disingenuous to pretend that my opinions aren’t shaped by the fact I have a personal stake in the matter. Today, though, and somewhat reluctantly, I am not just acknowledging my interests but explicitly putting Stratechery forward as an example of just how misguided the conventional wisdom is about the Internet’s long-term impact on society, in ways that extend far beyond newspapers (but per my point, let’s start there).

internet  business  strategy  trends  models  content  history 
6 weeks ago
« earlier      
!to_read addon advertising advice ajax amazon analytics android api apis apps architecture art article audio authentication backup blog book bookmarklet books browser business change chrome code cognition collaboration communication community comparison cool copyright creativity css culture data design development diy documentation economics editor education elearning email environment extension extensions facebook family favorite feedly finance firefox flash flickr food for free freeware fun funny future games generator github google graphics green hack hacks hardware health history home howto html http humor identity ifttt iftttfeedly iftttgr images information innovation inspiration interesting interface internet javascript jquery kids language later law learning library life linux list lists lsi mac management map mapping maps marketing math media metrics microsoft mobile money mp3 music network online opensource organization osx parenting patterns pdf performance philosophy phone photo photography photos php plugin plugins politics presentation privacy productivity productmanagement programming psychology read recipes reference research resource resources rest rss ruby sanfrancisco saved science script search security seo service sharing shopping social software startup startups statistics storage strategy sustainability teaching technique technology testing text time tips tool tools tracking travel trends tutorial twitter ubuntu ui usa usability usb useful utilities utility ux via:pocket video visualization web webdesign webdev wiki windows word wordpress writing xp youtube

Copy this bookmark: