HNHacker News
TopNewBestAskShowJobs

star-trek-fleet

751 karma · joined May 2, 2014

Opinions are my own.
submissionscomments
star-trek-fleet··on Professor Ehud Qimron: “Ministry of Health, it’s time to admit failure”
Well, there must be an indoctrination process happened sometimes in the history. After all, facial masks are not invented in ancient time people are not used to wear them.

So when the obedient Puritan people coming to this land. They are very cooperative in helping maintaining the community.

Through some indoctrination, they learned to stand up with their own wills. Turns out coins indeed always have 2 sides, right? When the individuals learn to stand up coercion with their own wills, they would stand-up against facial masks, vaccines, quanrintaines, etc.

star-trek-fleet··on Modern War Institute: We Ignore the Human Domain at Our Own Peril
> I always find articles like this very interesting, because what they're talking about is manipulating the worldviews, sentiments, desires, minds of people, and therefore behaviors, which is the ultimate goal. This is very intimate, and military people discuss it matter-of-factly.

If you look at the world, such feeling is not only prevalent, it's actually far more disturbing than you think.

For example, all ads industry is built on manipulating human emotions. And surfing the web, you are forced into so many such abusive staff every single seconds.

Look at the web content as well. When people staring at their phones, they are bring manipulated in the literal sense.

And you'll find every one of these AD's producers have a matter of factly explanation, or even glorified one.

Surprising?

Not at all. Karl Max predicted this inhumane end of the capitalism more than a century ago.

star-trek-fleet··on Professor Ehud Qimron: “Ministry of Health, it’s time to admit failure”
They definitely have a mask mandate.

But my question still remains, what exactly does the author suggest?

https://jp.usembassy.gov/covid-19-information/ There is also travel restrictions. Nothing is not the right word to use for Japan's covid policy.

star-trek-fleet··on Professor Ehud Qimron: “Ministry of Health, it’s time to admit failure”
Reading this, I am not sure what is the "right" policy in the author's mind.

The author argue that the ups and downs of infection is more of a innate dynamism of covid spreading, than any society wide policy. Is that suggesting there should not have been society wide intervention to covid? Like just keep things as normal.

Although I agree with the conclusion that the covid policy in US definitely has not been effective.

star-trek-fleet··on The leader who's standing up to China
Ms. Tsai is a skillful politician. Her success primarily lies on the adoption and the adept use of identity politics in Taiwan.

Despite a long history of national linkage with mainland China, Taiwan, under the colonization and brutal cultural and economic transformation by Japan invasion in the early 20 century till the end of WWII, have gone through a heart breaking separation from the homeland.

Ms. Tsai, just like her mentor, Mr. Lee Teng-hui are heavily influenced by liberal Democratic political ideology, and refined that with a modern form that is closer to western worlds. Mr. Lee Teng-hui represents a more Japanese heritage. And because of his disillusioned passion for communism, Lee had been a communist, and got bullied by KMT after the retreat.

Ms. Tsai led a whirlwind of political ascension through labeling "本省人” “外省人” political identities. Where she also mastered the online propaganda toolings eg the 1450 army (https://zh.m.wikipedia.org/wiki/%E7%B6%B2%E7%B5%A1%E6%89%93%...). Mrs. Tsai's domestic policy heavily rely on trade economic value for political ties like importing US pork with additive that are known to have harm to human https://zh.m.wikipedia.org/wiki/%E7%B6%B2%E7%B5%A1%E6%89%93%... And cultivation of national pride to distance the Taiwan island from mainland, and make the island more prestigious and similar to a national body. Like the so-called "advanced vaccine" by Taiwan's own Rd center https://www.dw.com/zh/%E5%8F%B0%E6%B9%BE%E5%BC%80%E6%89%93%E... these vaccines are rushed to public without adequate testing, and caused higher than usual death.

Ms. Tsai obviously has no adherence to the international law that recognize Taiwan as a part of China. And many Taiwan politicians are fearful of joining China for historical reasons. They even rejected Jiang Zeming's offer to retain it's own military and civil government, by just recognizing formally the CCP led central government, literally a federated nation.

Unfortunately, Taiwan's cultural linkage to China is weak. And the mainland is gearing towards a coercive reunification in some form that is appropriate to China's economic and political consideration. I.e., If China continue to grow and surpass US in all major aspects of national strength, Taiwan can keep this state indefinitely, as China does not really care that much when it becomes a more powerful US. But US won't allow that, global hegemony is a zero sum game, the loss of that status will destroy US financial industry, for an example of the consequence. And Taiwan for her self proclaimed high vision of independence, is heading into a dead end. As a weakening China will be more hostile to the island, Taiwan, in its own pursuit of some potlical value, will bring ruin to the island, probably bundled with significant damage to the mainland. Meanwhile, US would righteously declare the victory of democracy, and say nothing about the human suffering in the conflict, and exploit the economic loot afterwards.

In the end, I'll support the growth of China in all aspects of national power. Hopefully a better version of US can born from that. I'll do my best to influence the Western audience about the more complicated aspect of Taiwan issue, to broaden their view about alternatives than just the black and white democracy vs xxxx (authoritarian dictatorship swap any of your favorite words on China).

The US led world order is simply not going to sustain, everyone needs to understand not only US cannot make an example of the right and good, US no longer have the means other than destruction in shaping other nations' fate.

star-trek-fleet··on President Daniels responds to Chinese student's harassment
> Richer country

Trust me most students in US nowadays are family financial support. They are already rich. And the US do not often give enough working position for them (outside of tech, which h1b is not particularly friendly)

> better quality of life

This definitely is wrong. Those kids enjoyed a far better life in China than US.

> more personal freedoms.

Well, for what they want to do, they'll have more freedom...

star-trek-fleet··on Jndi: An irresponsibly bad logging library
You mean the the reaction to jndi logging RCE for log4j has been way too seriously?

What's the basis of this assessment?

Logging library fetching remote code and inject to local application runtime. Seems a pretty bad idea for any people with decent amount of programming experience, right?

Or I missed something.

star-trek-fleet··on Apple CEO Tim Cook 'secretly' signed $275B deal with China in 2016
> I guess as long as the tank tread on your neck is Chinese - it’s not a problem.

Are you implying mg Chinese identity will be a problem in US then? Are you threatening or are you joking?

> Better to be called a facist in democracy than to live in the authoritarian dictatorship you provide unceasing support to.

I provide uneasy support to China and CCP? No! I uneasily support the mutual understanding between China and US. And for now, the part that lacks understanding is US, and American people continue to allow themselves to be fooled by the mainstream media. While at the same time most of them do not even trust them anyway. It was just that the mental conditioning has been started since early 1900s since the rise of Communism that the distrust on MSM does not translate to critical thinking in the people's mind.

Yes for sure. My support for anything is uneasy. And only on a case by case and rational way.

I see the danger of blindfolded mindset to trigger the hot war between 2 nuclear super power. Then I act accordingly. Is that a support to China? Sure! It's a support to China just like Bill Clinton OKed China's joining to WTO. It's a support like Donald Trump squandered US supremacy and disunited the US allies. That does not make me or bill Clinton or Trump less American.

> I pity the people of China

Me too.

I support Chinese people's development. I am planning a nonprofit for my home province's education. We'll be helping youth coming to US and learn the history and culture in the American, so they have a more independent attitude towards government and power.

Like I said, changes take time, I want to contribute to the cultivation of western values in Chinese youth.

> who don’t have a say in their government

No no no...

This current iteration of Chinese government was created after the people overthrow the US backed KMT. They are going to overthrow CCP if CCP starts to behaving poorly. Look at the growing civil dissident during the haydays of rampant capitalism when people's lives are put on danger for the profits of the few.

> and have no choice but to tow the party line

They don't have choices in some basic politicians rules. Like CCP has to be the leader, and China had to be on socialism.

So what. American have to be on a 2 party system, and US has to be on a capitalist system. Is that so different?

> What’s your excuse?

I have no excuse. All I said is rational based on my own observation.

star-trek-fleet··on AWS is playing chess, Cloudflare is playing Go
> AWS has 17 ways to run containers and 7 ways to do async message processing, all overlapping and reinforcing and supporting each other, Cloudflare will tend toward introducing singular primitives, stuff them in a box, and try to ship those boxes to as many places as will possibly take them.

Actually AWS also "tend toward introducing singular primitives, stuff them in a box, and try to ship those boxes to as many places as will possibly take them."

It's just that AWS covers such a larger terrotery, that they appear fragmented.

This is why I now almost don't read this type of macro-analysis articles. They themselves lack the overall birds-eye view, because they are usually produced by people with little concrete technical background.

They often is very good at producing analogy, which is very intuitive, but very easily breakdown after moderate amount of details.

star-trek-fleet··on What Does Evergrande Meltdown Mean for China?
> Genocide of the Uighurs

It's not genocide in the conventional sense. As no people are killed. Maybe a cultural genocide.

star-trek-fleet··on Hong Kong: Police Raid Tiananmen Square Museum
Dude your comment is pure racism without self awareness. And a showing of ignorance beyond saving!

> You now get why it is pointless to argue with the Chinese

I suppose you say similar things in private, just swap Chinese with black, Mexican, Japanese etc.

It was OK to say this type of statement on “Chinese”, because, of cuz, even US president did this.

> And Hong Kong wasn't returned to China. It was Handed over.

Don't play the word on me...

The treaty was signed long time ago. And was the results of foticful invasion.

Returned or handed over, that's for Chinese, UK, and HK people to decide. You as a random (probably racism inclined as well) has no privilege to apply one word or another! And you are probably the least qualified as well, based on the amount of ignorance demonstrated in such a small number of words.

> You can also tell most of their assumption about China were taught when they were young.

WTF we Chinese told you things about China, and all those are what we were taught?!

First, is there anything wrong with that? You are boasting racism statements, which I assume was also taught in school? Is that OK?

And outside of class, we Chinese cannot learn the truth about China? For God's sake, CCP are not omnipotent entity who can control people's mind...

Or you are simply stating that Chinese are not capable of independent thinking, because we are just Chinese? (Of cuz, I am placing a racist trap for you, but likely that's what you are thinking right now...).

> It is always hard to break those assumptions.

Assumption?

I see things with my own eyes, and hear words with my own ears, and read books with my own mind.

You, someone, who randomly punce on Chinese topics, based on 300 years+ colonists education and indoctrination, and plagued by a racism bigot president, who should lead the nation on the positive and good, instead base his whole presidency on demonizing Chinese and China, are free from assumptions!?

You, are having a assumed righteous mindset, which couldn't be farther from the truth...

> Most part of Hong Kong doesn't belong to China for close to 150 years.

You failed to mentioned HK was abducted.

And UK applied brutal colonial ruling, and harsh indoctrination in all levels of the society.

Oh, of cuz, for someone who was decent from the people, who genocide the indigenous people, forgetting the source, omitting the root, is always the standard practice of demonizing the people with strong cultural roots...

> And you can read why they want Taiwan with so called unification.

What? Shed some light on the facts then.

> Taiwan wasn't even part of so called China for most of human history.

LMAO national states were not a thing for the most of human history, so what? Let's dissolve and ask UN to rule the world. I'll be very happy, if the head of the Mafia, would be willing to relinquish the supremacy...

> They also claims to be Anti-CCP.

Why? Why? Why do you relate to CCP? To paint a picture of hideous valin through association, right?

I am not surprised such ploy is well learned by the observers of the US mainstream media...

> But have done absolutely nothing against CCP.

When I was preaching the Chinese citizens rights and the need to stand strong against the bully and unfairness of the CCP officials, you would be calling me a CCP sponsored propagandist.

You are anti CCP, but only superficially in the name.

> But because their love of China they must save China first ( helping CCP ) before they somehow get rid of CCP.

What? Why save China needs to helping CCP? Are you suggesting that CCP is the only medium through which one can help improve China? I thought you are anti CCP, and want me to be one as well...

> Oh the irony.

Yep, your whole post is an irony. One that someone who does not have a clear mind, even muddier writing, delivered an outrageous irony of human ignorance...

star-trek-fleet··on Hong Kong: Police Raid Tiananmen Square Museum
Well, no, China's unification was a cultural and ethnicity blanding. It was never a genocide.

First I already debunked the notion that China conquered small nations to form its heritage. No China got it's heritage long ago through tribal merger.

And the US history of founding is patently different, and vastly more brutal and immoral...

star-trek-fleet··on Arm China Has Gone Rogue
> but loyal to China with deep CCP contacts

What are the evidence of this? Other than him being self interested and commit misconduct.

star-trek-fleet··on Software engineering research is a train wreck
I happened to also delved into machining tools and work as SWE full time.

This comparison to me, is not workable between machine building and software.

So the difference is that machines do simple things and not changing. But software do complicated things and always changing.

You can easily understand which parts and/or ways of operating that cause machine misbehaving. Because you have full grasp of the parts and how they assembled and work

But you cannot achieve the same for software, as each time it will be a new problem, or a new feature not working as expected.

Actually, if you think a bit more, you might realize that we actually cares very little about the microscopic features of machines. For example, no one cares about screws, as long as they are machined according to spec, and torqued correctly during installation. The chance that a random screw to bring down a whole machine is close to zero.

But any function in a software can bring down the whole software...

star-trek-fleet··on Paxos vs. Raft: Have we reached consensus on distributed consensus?
BorgMaster had its own consensus protocol prior to paxos lib. It was switched to paxos in 2010? (Don't quote me on this)

Chubby uses paxos. Iirc, the history is that Chubby comes first, then it's paxos code got pulled out into paxos lib, which proliferate inside Google.

And yes, Google had no other choice than Paxos at its days.

star-trek-fleet··on People Staring at Computers
Publicly displayed images vs. Only Google can see data

I think that's cognitively different concept. And I guess this distinction is also the hidden rationale of rejecting nationalized corporations to have similar power as Google, I.e., when they are nationalized, they suddenly conceptually exposed their information "public". Although in reality, a nationalized Google probably would never reach the same level of perversity as Google...

star-trek-fleet··on P4: Open-Source Programming Language for Protocol-Independent Packet Processing
IIRC p4 is losing ground to ebpf, right?
star-trek-fleet··on TikTok owner ByteDance sees its earnings double in 2020
He has no idea probably.

ByteDance's founder is an engineer, who happened to notice the fact that automation should come into content distribution in addition to all other aspects of social and economic activities.

So he started JinRiTouTiao, pretty much a DouYin/TikTok applied to text news. The narattive is this to give an analog. The fact is that DouYin/TikTok followed JinRiTouTIao's model.

TouTIao's content, like DouYin/TikTok, are manufactured to catch the attention. With attractive/provoking/(or whatever encourages clicking) titles, like the filtered/enhanced cover photo of any DouYin/TikTok video. The content is largely nonsensical, usually a rehash of some well-known old news. Just like DouYin/TikTok, just nonsensical videos to give you some short-term surge of satisfaction. The ads are mixed together with the manufactured content, which also has the same attractive title and content. Just like DouYin/TikTok.

The thing is that ByteDance, as a new generation of Internet company, becomes more fragile than any of its predecessors. In the sense that most of key factors of its success are based on machines, which are much easier to copy than things invovled more human activities (for example, it's easy to copy a successful anime, to make it successful, but it's much harder to copy the idea of a motion picture with actors and make it successful).

You can imagine someday, another startup, happen to invented a new AI that can generate content, whoola, ByteDance would be crumbling. If the founder would be as convicted as Mark Zuckberg, ByteDance would be killed in a few years...

star-trek-fleet··on China launches core module of new space station to orbit
> Prediction. By 2030 China will have its own 5nm and 3nm fabs.

Independent, and fully owning the IP, is the guiding principle of the current 5-year national plan.

Precise year or date is guess work, though.

But it's clear that the trajectory of innovation is on China's side. Innovation is built on top of resources, intellectual integrity, and market. Resources and market wise, China already surpasses US (in purchase power, and size in quantity and capital). Intellectual integrity is catching up. But I am confident in CCP's engineering prowess in that category.

After all, CCP engineered the biggest and the most important human mind transformation project in the entire human history: reforming China, from a feudal nation with thousands of years of continued cultural and political linage, to a socialism super power that reflecting not only the proud drawn from the long history, but also the unquenchable desire to rise and rise.

That's why I am amused by a lot of people's recognition on China. China is far beyond anyone's perception. The deeds condemned by popular critics are not even scratching the surface of CCP's impact on China...

star-trek-fleet··on Apache Mesos to be moved to Attic
> Mesos (and many other Berkeley AMPLab efforts) had briliant ideas behind it

Brilliant on paper.

The idea was influenced by MR workloads on Borg. Because MR is so large a workload pattern on Borg, that it benefits from having its own scheduler, and Borg also benefit from unnecessary meddling.

The idea was only brilliant for a very small number of human users, both inside Google and in the broader industry. In terms of CPU & memory usage, mesos' approach should always take great share, because workloads that in the category of needing their own scheduler always is the big ones.

But as an open source product, its adopters are far off from that group. So you can see that all early adopters of Mesos are large corps. I seldom hear any startup applaud Mesos.

Precisely, I have repeated many times when Mesos was still relevant, that its model makes it costly to get started. It will never succeed unless it start to package a product that can provide the scheduler part.

We all know what happened after K8s. K8s works because Borg already worked for 12+ years.

> an elegant implemention that allowed for much more than what Kubernetes was desgined to.

By design K8s is more capable then Mesos. Because K8s includes scheduler. And numerous other capability. Heck, excluding performance and scalability, K8s is a level a bove Borg in terms of feature and capability. Mesos is far behind Borg even, not mentioning K8s.

Mesos does offer better scalability, on paper. I had no experience though.

> Kubernetes was supposed to be scheduler for Mesos and Google invested in it.

I never heard of such plan.

star-trek-fleet··on “ISO obstructs adoption of standards by paywalling them”
True, but you missed the underlying concept of this statement.

The trend of innovation is increasingly becoming grassroots-driven.

In part, that's because our fundamental research advancement has stagnated, i.e., the nation states can no longer steadily produces ground breaking tech that leaves the industry to adopt. As a result the adopt of standards become more relevant to SMBs and individuals.

On the other hand, Internet has driven down the knowledge acquisition cost to probably bare minimal. I.e., modern days, one who has good understanding of English can learn pretty much any highest-level of knowledge almost for free. The SMBs and individuals are becoming more and more sophisticated, making them gradually become competent to be involved in the standardization process.

In short, ISO's practice is fine looking from a perspective of 10 years ago, but it's now wrong.

star-trek-fleet··on Why Working from Home Will Stick [pdf]
SF Bay area, used to commute to SF. Interestingly, every point you said was completely false for me:

> 1. Socializing is the primary activity that happens at work for the vast majority of workers. The gal or guy coming by your desk to "check in" or "see how your weekend was" etc... is literally where they find their social outlets and personal connections.

Not for me, or most of my cowoerks at Google. We absolutely would be doing more work by WFH. When we indeed going to hang out in the office with coworker, that's because we are bored by the work at hands, and need some outlet or simply resting. Not that we desire hanging out with coworkers.

> 2. Managers like to be able to watch their direct reports because it makes them feel more in control than they are

I never was in a team that managers need to see their reports. Most of the time, I often want to see my manager(s) in the office, but they were enjoying their meetings all day every day through the week.

> 3. The commuting routine, even if it's a nightmare, offers a sense of normalcy that most people have gotten used to and in a weird way rely on for grounding.

This sounds weird. I absolutely hate the commute. I am pretty sure that without the commute, my work output would double. Just by having those commute time being actual working hours.

I dont feel commuting is normal. Commuting isn't ideal for anyone. That's an unreasonable idea to me.

> 4. For a huge swath of Americans at least, work is an escape from the drudgery of the home.

That's somewhat true.

I indeed felt relaxed in office without being bothered by my children.

But now after all of us get used to the mode where my closed door means I am not to be disturbed, I absolutely love working from home. For example, if I need a rest, I can grab my younger son, and play with my older daughter. Fantastic experience! I think WFH have reshaped my relationship with my daughter because of more time together.

star-trek-fleet··on Remembering the Nanjing Massacre
NanJing massacre is one of the events in WWII where the animal cruelty manifests itself towards other humans.

As a Chinese born and raised in mainland myself, I am amazed at the ability of Chinese people to tolerate and coexist with this unspeakable brutality on our ancestors.

The whole event has a terrifying chilling effect on me: I never had enough courage to expose myself to those grumsome murderers done by the fellow humans. Not only they are directly harming my ancestors, the way they were performed has always been beyond my comprehension.

In some sense, I am afraid that I might suffer the demise of Iris Chang [1], where her exposure to the bloody facts caused severe mental stress. Which combined with the denial from Japanese government and right wing extremists, caused depression, and eventually her suicide.

I am also constantly puzzled by the denial from Japanese government regarding the war crime. For example, Japanese government is mad at the sculpture of comfort women [2]. Some times they succeeded at silence the expression [3].

Everyone involved should actually be open about what happened and collectively overcome the hurdles of historical events. Not denying, and automatically will trigger violent counter attack, which sustained a vicious cycle of hatred. See what happened in the African Americans and slavery and German's deeds for Holocaust. Where true concession indeed healed the wound largely.

I cannot help but guess that Japan's rejection of the war crime has truly been the culprit of the nation's disintegration in the east Asia bloc. Sadly caused a lot unnecessary frictions in the local geopolitical scene.

[1] https://en.m.wikipedia.org/wiki/Iris_Chang

[2] https://www.google.com/amp/s/news.artnet.com/art-world/comfo...

[3] https://www.google.com/amp/s/mobile.reuters.com/article/amp/...

Edit: to reply the comments below:

Actually, Japan denial is more puzzling, in that the facts are not to be held back by the Japanese government. For domestic violence, the ruling government still have full control of the facts and how to interpret them. In Japan's case, the evidence is all controlled by foreign nations because they were performed there.

star-trek-fleet··on Iran’s Top Nuclear Scientist Killed in Attack
Well, who did the things first to destabilize the region?
star-trek-fleet··on The End of the American Internet
There were a national debate on economy centered on the circulation of iron and salt. A representative work is "盐铁论” discussions on iron and salt.

Chinese civilization peaked in tang (in terms of international influence) and later song (in terms of tech and culture).

Then it's a steady declination till the end of Qing.

Ancient China was quite liberal and diverse even in modern standards. But the history took a reverse turn to more totalitarian direction. (China never practiced authoritarian regime, even today, people just cannot admit or bother to learn the nuances of modern China political system, I am so very much disappointed there is no modern day Tocqueville on China, what a pity!)

Xi's approach is fairly conventional in terms of Chinese tradition. But it has swapped the Confucius core with a blended scientific core through learning from Communism. This is a dangerous direction, as there is quite a risk of how to continue this tradition across generations, history has shown that declination and degradation is inevitable within 2-300 years time period. It will be interesting to see how Xi handles his succession. It might be quite disastrous. But it also has a lot of institutional safety backup.

Who knows! To me, this is the single most political affair in the next 10-20 years.

Xi is not a dictator, his life experience does not lend the ambition, nor his power can dominate the check and balance in China. Whoever labels xi a dictator is fooling his audience for some unspeakable purpose.

[1] https://baike.baidu.com/item/%E7%9B%90%E9%93%81%E8%AE%BA

star-trek-fleet··on How To Be An Anti-Casteist
Do you have an English source on this reported incident? It sounds beyond modern day concept of cruelty.
star-trek-fleet··on Go modules have a v2+ problem
> Google certainly has the resources to fill the gap

Quite possibly they dont have the resource.

The eng culture today is dominanted by visible impact. Documents are great for everyone, every Googler knows that, but it just cannot be measured.

I wrote some of the most spectacular docs in my previous Google teams. Everyone loves it when they saw them. And no one mentioned them in any formal scenarios. And I am aware of the measurement rules well enough that I didn't bother to waste my time to promote them.

For me, I just care the feelings of the users so much that I personally feels rewarded, but for Google as a whole, there cannot be enough resources for documentation, by the design of the engineering system.

star-trek-fleet··on Elite do-gooders 'fixing' the world are part of the problem: Giridharadas
Nothing you cited are one percenter problem, they were branded as such to keep you from emotionally involved, which in turn might give you the mental strength to push for the right things to happen.

Any of these problems, can directly affect your children.

Let me tell you one example, my parents generation suffered much higher cancer rate than normal. That's caused by 40 years of rapid industrialization in China.

Think about it, these issues let limbo, will very likely make your retirement miserable in 20-30 years...

star-trek-fleet··on Trump says he will ban TikTok through executive action
> purged nearly all aspects of traditional Chinese society

There has been multiple rounds of racial genocide in China's history, some by internal turmoil, and more by external invasion. Yet the Chinese culture survived.

It might sounds incredible, but so many people in such a huge land, have its own life strength.

If you think a political dictator can purge a nation's history tie, in 10 years, without actually killing all the people, then you are certainly underestimate Chinese people's strength and ernacity...

star-trek-fleet··on Design Docs at Google
Hah, design docs at Google...

I read probably hundreds of deigns docs during my 6 years at Google.

I think among them, only a handful of design docs, like < 10, are considered clear, clean, and succinct. And all of them are more or less retrospective ones summarizing a system after it's already being implemented and running for a while.

The newer design docs, which are served as actual working documents for an active projects, are no doubt primarily a process mechanism to solicit design inputs, and garner supports from stakeholders.

It is a formality to show that the project owner is willing to waste his time and to convince so-called "reviewers" about the validity of the project. The reviewers usually do not read the design doc in earnest. Only the stakeholders, like the TL of the team, potential customers, partners, would spend serious time on them. It's more or less a debate ground for stakeholders to pointing fingers at the design process. That's also why the design doc is written in Google Doc in the first place.

Once a design is "approved", it usually means from most major share holders are satisfied, to everyone is wearied down enough and the project has enough importance to actually push forward, they are OKed for implementation.

After that the design doc is largely useless, the designs laid out in the doc is usually 1) too simple that there is no need to consult design doc anyway, one can explain it in a few minutes chat; 2) too complicated that the design diverges from the actual code that the design doc offers little guidance. And very few design docs sit in between.

All in all, anything produced during a software engineering project seems all is about being a tool for organizing the human interaction process, the artifact, aside from a very high-level motivational piece, and the end result code + docs, whatever in between seems largely bears little value after the work is done.

Page 1 of 2Next →