[RFC] Replace "parallel learning" in docs with "distributed learning"?

[jameslamb]

LightGBM comes with the ability to use multiple machines for training. This can be done with the CLI, or with integrations like Spark, Kubeflow Fairing, and Dask (#3515 ).

Today, the docs refer to training with multiple machines as "parallel learning".

I think that this is not quite precise enough, and can lead to some confusion.

LightGBM has at least two types of parallelism:

• within one process (shared memory), using multithreading with OpenMP
• across multiple processes (possibly on multiple machines, and with distributed data), using either sockets or MPI

https://lightgbm.readthedocs.io/en/latest/Parallel-Learning-Guide.html#parallel-learning-guide only refers to the second case today.

I think we should rename this guide to "Distributed Learning" and use the word "distributed" everywhere in the documentation that talks about using multiple machines to accomplish model training.

Wanted to open this request for comment before I start making changes. What do you think?

[StrikerRUS]

I'm +1, BUT with keeping old links alive.

[guolinke]

agree with @StrikerRUS

[jameslamb]

ok thanks! I'll prepare a PR.

I also agree on preserving the prior links

[github-actions]

This issue has been automatically locked since there has not been any recent activity since it was closed. To start a new related discussion, open a new issue at https://github.com/microsoft/LightGBM/issues including a reference to this.