Github user alpinegizmo commented on a diff in the pull request:
https://github.com/apache/flink/pull/5922#discussion_r184971409
--- Diff: docs/dev/stream/state/broadcast_state.md ---
@@ -0,0 +1,281 @@
+---
+title: "The Broadcast State Pattern"
+nav-parent_id: streaming_state
+nav-pos: 2
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+* ToC
+{:toc}
+
+[Working with State](state.html) described operator state which is either
**evenly** distributed among the parallel
+tasks of an operator, or state which **upon restore**, its partial (task)
states are **unioned** and the whole state is
+used to initialize the restored parallel tasks.
+
--- End diff --
I find this intro paragraph confusing. Would it be correct to rewrite it
like this?
[Working with State](state.html) describes operator state which **upon
restore** is either **evenly** distributed among the parallel tasks of an
operator, or **unioned**, with the whole state being used to initialize the
restored parallel tasks.
---
