[STORM-557] Created docs directory and added in some svg diagrams.

[revans2]

No description provided.

[harshach]

+1

[HeartSaVioR]

Amazing for sharing high-res svg diagrams! Thanks!

[revans2]

I was curious if we wanted to keep a 5MB file in our github repo that everyone must download to get storm? As it stands now the git repo is about 11MB total. This could slow things down for some developers. It might be better to put it in the SVN repo with the web page source

http://svn.apache.org/viewvc/storm/

But it would make it less accessible to developers who might want to reuse it.

[harshach]

@revans2 There is another JIRA asking for the current storm.apache.org docs to be moved onto github.
https://issues.apache.org/jira/browse/STORM-544.
As @HeartSaVioR pointed out about redis-doc https://github.com/antirez/redis-doc. I am +1 on moving all storm related doc onto its own github repo. Makes it easier for community to contribute to the docs.

[revans2]

OK so the next question I have is, should we split the one big SVG file up along side rasterized PNG equivalents for use in the docs?

[harshach]

@revans2 sounds like a good idea to provide PNG files.

[revans2]

OK I split them apart, cleaned up one of the SVG images to make it smaller, and added in some PNG versions, along with updating the security document to use one of the PNG images. So now the total new size is 3.6 MB. Hopefully a lot more people will find these useful.

[revans2]

With pull #330 now up, I will wait for it to go in, and then rebase my changes on top of it.

[harshach]

@revans2 can you please upmerge your patch. Thanks.

[revans2]

Enough changed with the docs update, that I opted to just add the images in. If we want to move some of the other markdown documents over we can, but for now I just left them where they were.

[kishorvpatil]

+1

[kishorvpatil]

Thank you @revans2.