Skip to content

docs: add missing 3.0.0 feature documentation#8949

Merged
rzo1 merged 2 commits into
masterfrom
docs/3.0.0-new-features
Jul 25, 2026
Merged

docs: add missing 3.0.0 feature documentation#8949
rzo1 merged 2 commits into
masterfrom
docs/3.0.0-new-features

Conversation

@reiabreu

Copy link
Copy Markdown
Contributor

Summary

Adds documentation for features shipped in Storm 3.0.0 that were absent from the release docs index.

  • Binary-distributions.md — explains the full vs. lite distribution (apache-storm-<ver>.tar.gz vs apache-storm-<ver>-lite.tar.gz), what each omits, how to restore optional components with bin/storm-autocreds-fetch and bin/storm-kafka-monitor-fetch, and the lib-common jar deduplication
  • JitterAwareStreamGrouping.md — covers the RFC 1889 EWMA jitter metric, how JitterAwareStreamGrouping uses it to route away from high-jitter tasks, usage, and when to prefer it over shuffleGrouping
  • Local-dev-cluster.md — documents the Docker Compose dev cluster under docker/ (Nimbus, ZooKeeper, two Supervisors, Prometheus, Grafana) and the netsim.sh network simulation utility
  • Storm-Scheduler.md — adds an EvenScheduler section covering the opt-in idle supervisor rebalance pass and its configuration keys
  • index.md — links all new pages and fixes the existing Cluster-State-Serialization.md which was present in the docs directory but not reachable from the index

Test plan

  • Run rsync from storm root into a local storm-site checkout and verify all new pages appear under releases/3.0.0/
  • Build storm-site locally (bundle exec jekyll serve) and confirm all links resolve

🤖 Generated with Claude Code

reiabreu and others added 2 commits July 25, 2026 15:21
- Binary-distributions.md: full vs. lite distribution, fetch scripts for
  storm-autocreds and storm-kafka-monitor, lib-common deduplication
- JitterAwareStreamGrouping.md: RFC 1889 EWMA jitter metric, usage, when
  to use vs. shuffleGrouping
- Local-dev-cluster.md: Docker Compose cluster, Prometheus/Grafana, netsim.sh
- Storm-Scheduler.md: EvenScheduler idle supervisor rebalance section
- index.md: link all new pages; link existing Cluster-State-Serialization.md
  which was present but unreachable from the index

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Document the secondary sort (free slots) and tertiary sort (hostname)
added in 3.0.0 that reduce worker evictions when assigning isolated
topologies to hosts of equal total capacity.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@reiabreu
reiabreu marked this pull request as ready for review July 25, 2026 14:27
@reiabreu reiabreu added the documentation Improvements or additions to documentation label Jul 25, 2026
@reiabreu reiabreu added this to the 3.1.0 milestone Jul 25, 2026
@reiabreu

reiabreu commented Jul 25, 2026

Copy link
Copy Markdown
Contributor Author

@rzo1 @GGraziadei asked Claude to detail changes introduced in 3.0.0 to our documentation.
If approved, I can retroactively add them to the Storm website.

@reiabreu

Copy link
Copy Markdown
Contributor Author

@rzo1 I've also improved the release notes.
I had stated that the API is fully compatible with Storm 2, which is true for Java but not for Clojure.

Obviously, feel free to edit what I wrote.

image

@rzo1

rzo1 commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

Nice. Thx

@rzo1
rzo1 merged commit 8df4908 into master Jul 25, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants