mikhail.barg's blog

By mikhail.barg, 13 years ago, In English

There's a question I've been asking myself for some time already. It is "Can you name a program that you totally satisfied with?" After reading "Software vs. Hardvare" post in VC15 blog, I came to this thought again.

What's kinda depressing me, is that I cannot remember a program that I could say to be so good that it does what it is meant to do and does not give me any frustration/dissatisfaction in any way.. Maybe there are some games that are made really nice, but what's about not-gaming software?

So I'd like to address this question to the whole community here: "Can you name a program that you may frankly say to be flawless?"


Full text and comments »

  • Vote: I like it
  • +9
  • Vote: I do not like it

By mikhail.barg, 13 years ago, translation, In English

Well, yes. Documentation. You know that you have to write it for your code, but you never write it, because it's soo boring. And when you have to deal with other's code, you blame them for not writing the documentation.

OK, all clear, next post please.

Well, if you are still here, that's what I wanted to say. There are many huge projects done by serious companies with lots of the documentation. And it's clear that they spent lots of time on documenting all and every public function. But still they are doing it in a wrong way! Lots of documentation is not great by itself!

There's so many times you see the detailed explanation of functionality having no idea  how does it apply to your case. The latest example for me was the Google Web Toolkit documentation. It's kinda big and has all kinds of tutorials and articles. It gives you step by step guide for creating a working project. But still it gives no idea, if that's what you wanted or how GWT is designed to be used. Or how it works inside.

Full text and comments »

  • Vote: I like it
  • +6
  • Vote: I do not like it