aljoscha opened a new pull request #11730: [FLINK-17009] Fold api_concepts.md 
into DataStream documentation
URL: https://github.com/apache/flink/pull/11730
 
 
   ## What is the purpose of the change
   
   This is moving towards the goal of FLIP-42 of having only DataStream, 
DataSet, and Table API as the only top-level documentation sections under the 
API section.
   
   My goal with this is also that the DataStream API Overview gives a full 
guide for users starting with the API. After this change, a user does not first 
have to read basic concepts but the DataStream API overview is sufficient and 
the information is in the right place.
   
   This move different sections from `api_concepts.md` to different "top-level" 
sections, depending on what seems right. For example, "Specifying Keys" is 
moved to the state documentation. The section about user functions is moved to 
a new "User-Defined Functions" page.
   
   I will create a Jira issue for updating the Chinese documentation once this 
is merged. I meticulously "logged" the steps via commits so that a translator 
can apply the same changes.
   
   Please look at the individual commits, they document what's going on quite 
well. Also take a look at the flow of the updated DataStream API Overview page.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
[email protected]


With regards,
Apache Git Services

Reply via email to