Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

After reading this article I can relate it event trace (Chrome tracing) design doc form google, very succinct to the point: https://docs.google.com/document/d/1CvAClvFfyA5R-PhYUmn5OOQt...!


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.


And 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.


Yes and the way you can tell is the doc title is "FooBar Design Doc" but the shortlink is "foobarforperf".




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: