[STORM-1544] Document Debug/Sampling of Topologies

[arunmahadevan]

Added documentation for logging/sampling events in a topology.

[HeartSaVioR]

+1
I think we can add a note about performance issue regarding #1217 when we're sure it does have performance hit.

[revans2]

It looks good can we add a link to this in docs/index.md as well? Otherwise it will not be easy to find in the UI.

[ptgoetz]

@revans2 The yaml front matter documentation: true should take care of that.

+1

[revans2]

@ptgoetz Not for the release specific docs. At least I didn't end up setting it up that way, and so if I missed something, then I am happy to go back and try and fix it.

[ptgoetz]

@revans2 Okay. I didn't realize that had changed, I'm okay with either approach.

One thing I did notice is that the documentation dropdown is missing from the home page, and the downloads page is now a 404.

(sorry for hijacking this pull request)

[revans2]

@ptgoetz I didn't realize that we were generating an index using the docs tag. I am happy to go back and add something in again for it.

Also everything is working fine for me. what browser are you using? is there something in your cache that is messed up? Just FYI I renamed the download.html to releases.html, because it includes more then just download links, but the download button points to the proper place. I am happy to revert that change too if you had other stuff pointing to it.

[harshach]

@revans2 we should add redirection from downloads.html to release.html.

[ptgoetz]

@revans2 It was a caching issue. Sorry for the noise.

I agree with @harshach, we may want to consider a redirect from downloads.html to release.html to keep from breaking external links and bookmarks.

I think we need to add a link to the KEYS file for releases, and it might help to add maven information like we did in the old downloads page.

[arunmahadevan]

@revans2 @ptgoetz added a link in docs/index.md

[HeartSaVioR]

+1 again.
I think we can grep issues on website and raise an issue to follow up.

[arunmahadevan]

Appears that some html pages are broken. E.g. http://storm.apache.org/releases/1.0.0-SNAPSHOT/State-checkpointing.html beyond the section "IStateful bolt hooks", the formatting and sections headings are lost. Do we need to fix something in the scripts that generate the html files ?

[ptgoetz]

@arunmahadevan That's likely a typo or formatting error in the markdown file.

[arunmahadevan]

@ptgoetz updated the doc to reflect the new (disabled by default) behavior. Please review.

[HeartSaVioR]

+1