Documentation Link
No response
Problem
#29124 aims to add a section "Plotting data" to the user guide. In #29124 (comment) I requested to define the purpose, structure and content of that section, because I'm afraid without that, the section will not converge to a consistent or intended state.
To not just complain about what is missing, I sketich an initial suggestion below.
Suggested improvement
In a first step, I would like to define the goal of "Plotting data". As an example to guide where I'm trying to go, I state my interpertation of the goals of "Plot types"
Goal of Plot types
Primary goal (reason for existence): Overview of the types of visualizations, The user can browse the images and see what kind of visualizations matplotlib is capable of.
Secondary goals (added benefit):
- grouping by type of data: We can use sections to group the visualizations. This makes it easier to comprehend the the whole set of visualizations and to find related visualizations (I might be looking for bars, but could realize stairs are even better for my case).
- Linking to respective plotting functions. Once I have decided on a visualization, I can jump to the (API) documentation of the repective plotting function.
Now here is my interpretation for "Plotting data"
Goal of Plotting data
Primary goal (reason for existence): Explain how individual plotting functions are used.
Secondary goals (added benefit): to be defined, if any
Please disuss this
After we have agreed on that, we can justify/define the structure (should we group by type of data or have a plain list of plotting functions), and content guidelines. as is done in https://matplotlib.org/devdocs/devel/document.html#plot-types-guidelines
Documentation Link
No response
Problem
#29124 aims to add a section "Plotting data" to the user guide. In #29124 (comment) I requested to define the purpose, structure and content of that section, because I'm afraid without that, the section will not converge to a consistent or intended state.
To not just complain about what is missing, I sketich an initial suggestion below.
Suggested improvement
In a first step, I would like to define the goal of "Plotting data". As an example to guide where I'm trying to go, I state my interpertation of the goals of "Plot types"
Goal of Plot types
Primary goal (reason for existence): Overview of the types of visualizations, The user can browse the images and see what kind of visualizations matplotlib is capable of.
Secondary goals (added benefit):
Now here is my interpretation for "Plotting data"
Goal of Plotting data
Primary goal (reason for existence): Explain how individual plotting functions are used.
Secondary goals (added benefit): to be defined, if any
Please disuss this
After we have agreed on that, we can justify/define the structure (should we group by type of data or have a plain list of plotting functions), and content guidelines. as is done in https://matplotlib.org/devdocs/devel/document.html#plot-types-guidelines