Reorganize method flowchart for class based generic views to tree

[shoul@…]

It would be nice to have a tree that build up the flowchart.

[Florian Apolloner]

As seen on a pycon-de presentation, a treelike structure is easier to follow visually.

[Tim Graham]

Component should be documentation I assume? What page does this refer to?

[ohumbel]

This refers to: /ref/class-based-views/generic-display.html,
source: /docs/ref/class-based-views/generic-display.txt

[ohumbel]

render both detail and list method flowcharts as tree structures

[ohumbel]

please note that the space before a dedent is due to the css

[Tim Graham]

Ah, makes sense. Would also be helpful to add a description of what the "method flowchart" is trying to show I think.

[Daniel Greenfeld]

I would love to have a tree view of the method flowchart. In fact, that is what I originally submitted. However...

Even a Tree view is not adequate. Trying to describe if/else boolean logic in bullets turns out to be rather confusing. The methods really need a proper flowchart, not a text tree. Something perhaps even done in Graphviz.

Indeed, months ago @Jacobian started to work it in Graphviz and then ran out of free time while working on the format for the Method flowchart.

[Garry Polley]

I've started taking a look at a gist from @Jacobian ​https://gist.github.com/jacobian/5020615. I want to attempt to find a way to automate the creation of these graphs.

Either way I'll try and get some more graphs done this Django sprint.

[Steven Cummings]

@garrypolley would this include new info in the "writing documentation" section of the contributing HOWTOs?

[Garry Polley]

@estebistec I do not plan to update the "writing documentation" section. After looking into writing a graph generator and talking to @jacobian I don't think it's a good idea to make the graphs. It's rather difficult and where do you decide to start the graph? Do you start at dispatch? Do you list every method call in side each method?

Looking into ccbv.co.uk and seeing if there is a good way to fork it so it will auto generate a version with each django release/branch. I think ccbv.co.uk does a good job of showing what you can access on a CBV and it's more detailed than a graph would be. I'm not convinced a graph or flow chart is better than just using that site.