News for hackers. Stuff that matters.
Re:Ask HN: How do you create diagrams in documentation? by BraveNewCurency on Tuesday February 04, 2014 @08:56PM (#7181457)
If you want a diagram you can embed in text and check into source control, take a look at GraphViz. http://www.graphviz.org/

You can even embed it in other things, like Wikis. https://www.mediawiki.org/wiki/Extension:GraphViz

Re:Ask HN: How do you create diagrams in documentation? by alok-g on Wednesday January 29, 2014 @11:21AM (#7144784)
Microsoft Word and PowerPoint.

Sometimes Excel when diagram could be made by drawing borders around cells and resizing rows and columns as per need. This helps when unplanned non-linear horizontal and vertical scaling is needed while making the diagram.

The SmartArt concept they introduced was quite promising, though I find the current state of it lagging. I am sad that it never picked up.

Re:Ask HN: How do you create diagrams in documentation? by fromdoon on Wednesday January 29, 2014 @09:16AM (#7143898)
I had started with using MS Visio at my job. Though I had absolutely no experience in making diagrams, Visio was quite easy to get started and become comfortable in quick time.

The downside of course is that it is not free.

I would also like to know open source alternatives to MS Visio. I can see that Ubuntu 12.04 comes with Libre Draw, but I haven't tried it yet.

Re:Ask HN: How do you create diagrams in documentation? by ahtomski on Wednesday January 29, 2014 @10:47AM (#7144501)
Have you tried UMlet? It's limited but great for nailing UML diagrams.
Re:Ask HN: How do you create diagrams in documentation? by phantom_oracle on Wednesday January 29, 2014 @11:12AM (#7144694)
LibreOffice Draw is reasonable if you are coming from Linux.

Otherwise there is GIMP too.

+1 to all the other open source solutions mentioned here.

Re:Ask HN: How do you create diagrams in documentation? by radq on Wednesday January 29, 2014 @09:06AM (#7143839)
Re:Ask HN: How do you create diagrams in documentation? by ahtomski on Wednesday January 29, 2014 @09:46AM (#7144071)
Yeah I quite like Gliffy. More often than not, we take photos of whiteboards and email them round the team.
Re:Ask HN: How do you create diagrams in documentation? by hnjake on Thursday January 30, 2014 @05:13AM (#7149874)
Give www.draw.io a go. I have used it a few times at work.
Re:Ask HN: How do you create diagrams in documentation? by rsmaniak on Wednesday January 29, 2014 @07:14AM (#7143365)
Gliffy(www.gliffy.com) works great for me.
Re:Ask HN: How do you create diagrams in documentation? by atsaloli on Thursday January 30, 2014 @03:03AM (#7149535)
Blockdiag
Re:Ask HN: How do you create diagrams in documentation? by chatmasta on Wednesday January 29, 2014 @12:05PM (#7145122)
Balsamiq
Re:Ask HN: How do you create diagrams in documentation? by bsaunder on Wednesday January 29, 2014 @07:17AM (#7143374)
Inkscape