Hacker News new | past | comments | ask | show | jobs | submit login

> Great example of why diagrams are a waste of time.

I need something for the tech people, and I need something for the money people.

The diagram gives my target audience (again, non-tech people) an overview of the system. There were sequence diagrams for all the functionality we wrote code for. Technical specs and documentation were also written up, but the money people won't bother to wade through that to understand how it works; the dev team can read that.

> Why does the app have to generate the id for example? What's wrong with the email address as an id?

The example was extracted from a project I worked on a couple of years ago. I obfuscated what the "id" field is on purpose. If it helps, think of it as the unique device identifier used to send push notifications.

> So not only is it uninformative, it's probably wrong.

They were not inaccurate.




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

Search: