56 karma · joined December 17, 2014
I built it a few months ago, and my team at Square has been using it to save time during both development and debugging when interacting with gRPC and proto-over-http servicse defined in protobuf.
If you use protobuf-based services, please feel free to play with it and let me know what you think!
I completely agree that people in most companies do not push down P99 enough.
I think this is a direct response to the second question, and assumes that people are setting timeouts statically. Is my understanding correct?
However, to make the institutional knowledge useful, it must be easy to find. Thus, I think the second most important thing for capturing institutional knowledge is to have a small number of easily searchable places where documentation lives. Markdown files in the source are convenient place for documenting particular projects or code, but more general-purpose knowledge should be in a wiki or any other document store that is centrally searchable and update-able. An example of such general purpose knowledge is "how-to knowledge": How do I request the appropriate privileges to integrate my service with Service X? How do I make and deploy a staging build? How do I set up a new service?
Another sort of general-purpose knowledge that should have a single home is knowledge around context for past decisions that were made for good, but not obvious reasons. My team maintains a document called a Decision Log, where we record the context around and reasons for every decision that required more than roughly 10 minutes of thought. Longer decisions have their own docs, but they are linked from the central Decision Log.
The API is to shorten is simply a POST request to hq6.me/u/ with `fullUrl` and optional `desiredShortUrl` as parameters.