display='diagram' needs more prominence in documentation

The sklearn.set_config(display='diagram') feature highlighted here needs more prominence. At least, it should be easy to find it when googling scikit-learn diagram display. It isn’t. scikit-learn display=diagram is much the same, and scikit-learn "display=diagram" is on the mark but the results are not easy to parse as being relevant.

We probably need an example, or a user guide page, showing how different estimators are diagrammed, and perhaps also instructing users to use IPython.display’s display function when needed.

[reshamas]

@cmarmo I haven’t had time to work on this, so if someone wants to take it over, it’s available.

[NicolasHug]

I didn’t realize that the code in the UG is not executed by sphinx, and thus we can’t see diagrams in the UG. It seems that we should create a dedicated example then, with various pipelines / estimators of different complexity. Would you be interested in doing that @reshamas ? @hongshaoyang also showed interest

Some examples of estimators worth rendering (feel free to deviate):

• single estimator like SVC
• basic pipeline
• complex pipeline with ColumnTransformer (as in the other example linked above)
• GridSearch within a pipeline, or GridSerach over a pipeline