SZEDER Gábor <szeder.dev@xxxxxxxxx> writes: > At the top of 't6120-describe.sh' an ASCII graph illustrates the > repository's history used in this test script. This graph is a bit > misleading, because it swapped the second merge commit's first and > second parents. Hmm... > +# ,---o----o----o-----. > +# / D,R e \ > +# o--o-----o-------------o---o----x > +# \ B / > +# `---o----o----o-' > +# A c What's the first parent of the merge between 'B' and 'c' in this picture and how does the reader figure it out? What about the same question on the direct parent of 'x'? Is it generally accepted that a straight line denotes the first ancestry, or something? I do not offhand see between these two the new one is a clear improvement. I do agree with the issue with illustrating topology, and it is an issue worth addressing. In the past when the order of parents mattered, I experimented to find ways to depict them clearly, without much success. One of the things I tried was to label the parents, like so: > - B > - .--------------o---1o---2o----x > - / 2 1 > - o----o----o----o----o----. / > - \ A c / > - .------------o---o---o > - D,R e but I did not find it very satisfactory. In any case, since this step is about "improving" the illustration, I'd like to see a clear improvement. Perhaps an extra comment that says "straight line is the first parent chain" next to the drawing might qualify as such. Thanks.
