[SDP] DataflowGraph.reanalyzeFlow

Author: jaceklaskowski

docs/declarative-pipelines/DataflowGraph.md

@@ -11,7 +11,7 @@
 `DataflowGraph` is created when:
 
 * `DataflowGraph` is requested to [reanalyzeFlow](#reanalyzeFlow)
-* `GraphRegistrationContext` is requested to [toDataflowGraph](GraphRegistrationContext.md#toDataflowGraph)
+* `GraphRegistrationContext` is requested to [convert to a DataflowGraph](GraphRegistrationContext.md#toDataflowGraph)
 
 ## reanalyzeFlow { #reanalyzeFlow }
 
@@ -20,14 +20,22 @@ reanalyzeFlow(
   srcFlow: Flow): ResolvedFlow
 ```
 
-`reanalyzeFlow`...FIXME
+`reanalyzeFlow` [finds the upstream datasets](GraphOperations.md#dfsInternal).
+
+`reanalyzeFlow` finds the upstream flows (for the upstream datasets that could be found in the [resolvedFlows](#resolvedFlows) registry).
+
+`reanalyzeFlow` finds the upstream views (for the upstream datasets that could be found in the [view](#view) registry).
+
+`reanalyzeFlow` creates a new (sub)[DataflowGraph](#creating-instance) for the upstream flows, views and a single table (the [destination](Flow.md#identifier) of the given [Flow](Flow.md)).
+
+`reanalyzeFlow` requests the subgraph to [resolve](#resolve) and returns the [ResolvedFlow](ResolvedFlow.md) for the given [Flow](Flow.md).
 
 ---
 
 `reanalyzeFlow` is used when:
 
-* `BatchTableWrite` is requested to [executeInternal](BatchTableWrite.md#executeInternal)
-* `StreamingTableWrite` is requested to [startStream](StreamingTableWrite.md#startStream)
+* `BatchTableWrite` is requested to [executeAsync](FlowExecution.md#executeAsync) (and [executeInternal](BatchTableWrite.md#executeInternal))
+* `StreamingTableWrite` is requested to [executeAsync](FlowExecution.md#executeAsync) (and [startStream](StreamingTableWrite.md#startStream))
 
 ## Resolve { #resolve }
 

docs/declarative-pipelines/GraphOperations.md

@@ -0,0 +1,3 @@
+# GraphOperations
+
+`GraphOperations` is...FIXME

docs/declarative-pipelines/GraphRegistrationContext.md

@@ -16,7 +16,7 @@
 
 * `DataflowGraphRegistry` is requested to [createDataflowGraph](DataflowGraphRegistry.md#createDataflowGraph)
 
-## Create DataflowGraph { #toDataflowGraph }
+## Convert to DataflowGraph { #toDataflowGraph }
 
 ```scala
 toDataflowGraph: DataflowGraph

docs/declarative-pipelines/ResolvedFlow.md

@@ -0,0 +1,3 @@
+# ResolvedFlow
+
+`ResolvedFlow` is...FIXME