3 ms·
That is not a design doc, that is a format specification. It jumps directly to the implementation details without discussing the motivation. The reader has no w
by jeffbee 6y ago
That is not a design doc, that is a format specification. It jumps directly to the implementation details without discussing the motivation. The reader has no way to evaluate the utility of the example JSON because the doc has not stated any use cases.
- cmrdporcupine 6y agoAnd frankly that's how most of the design docs at Google really are. They're post-facto descriptions put together for the purpose of gaining promotion.
- jeffbee 6y agoYes and the way you can tell is the doc title is "FooBar Design Doc" but the shortlink is "foobarforperf".