[jira] [Created] (FLINK-18377) Rename "Flink Master" back to JobManager in documentation

["Aljoscha Krettek (Jira)" <ji...@apache.org>]

Aljoscha Krettek created FLINK-18377:
----------------------------------------

             Summary: Rename "Flink Master" back to JobManager in documentation
                 Key: FLINK-18377
                 URL: https://issues.apache.org/jira/browse/FLINK-18377
             Project: Flink
          Issue Type: Task
          Components: Documentation
            Reporter: Aljoscha Krettek
            Assignee: Aljoscha Krettek


From the ML thread (https://lists.apache.org/thread.html/red9d18f7173d53d016f6826410841b2726b9293ceefaea2de0cdeafb%40%3Cdev.flink.apache.org%3E) :

This came to my mind because of the master/slave discussion in FLINK-18209 and 
the larger discussions about inequality/civil rights happening right now 
in the world. I think for this reason alone we should use a name that 
does not include "master".

We could rename it back to JobManager, which was the name mostly used 
before 2019. Since the beginning of Flink, TaskManager was the term used 
for the worker component/node and JobManager was the term used for the 
orchestrating component/node.

Currently our [glossary|http://example.com] defines these terms (paraphrased by me):

  - "Flink Master": it's the orchestrating component that consists of 
resource manager, dispatcher, and JobManager

  - JobManager: it's the thing that manages a single job and runs as 
part of a "Flink Master"

  - TaskManager: it's the worker process

Prior to the introduction of the glossary the definition of JobManager 
would have been:

  - It's the orchestrating component that manages execution of jobs and 
schedules work on TaskManagers.

Quite some parts in the code and documentation/configuration options 
still use that older meaning of JobManager. Newer parts of the 
documentation use "Flink Master" instead.

I'm proposing to go back to calling the orchestrating component 
JobManager, which would mean that we have to touch up the documentation 
to remove mentions of "Flink Master". I'm also proposing not to mention 
the internal components such as resource manager and dispatcher in the 
glossary because there are transparent to users.

I'm proposing to go back to JobManager instead of an alternative name 
also because switching to yet another name would mean many more changes 
to code/documentation/peoples minds.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)