-6

It is helpful to draw diagrams to illustrate a question or an answer. Since UML is the lingua franca of software descriptions, it'd be useful to be able to include such diagrams too. Right now the process is a bit cumbersome and requires the use of offline tools to grab screenshots to be transferred over to Imgur. It'd be neat if one could use an integrated tool from within a question or an answer.

Just as the electrical engineering Stack Exchange site has integrated CircuitLab, it'd help SE to integrate something like Gliffy or a similar tool.

I'm not affiliated with Gliffy or anyone else other than my wife and kids, for that matter.

9
  • 9
    I've rarely seen any questions that can't do without UML diagrams. In those cases, if there has to be a diagram, a screenshot of one works just as well. I don't see how the effort required to implement this would be worth it. For EE on the other hand, circuit diagrams are often crucial to explain what's (supposed to be) going on.
    – Cerbrus
    Commented Sep 17, 2015 at 13:28
  • 2
    This probably wouldn't be a bad idea on Programmers, but you still already have the option of posting images there too. Commented Sep 17, 2015 at 13:37
  • @Cerbrus I'm an EE, and I can trivially generate an isomorphic human-readable textual description for any circuit, so by that line of thinking why bother with circuit diagrams either? I mean, I just gave you a counterexample that works for every EE question: they all could do with a textual description only! I lament that the clarity and simplicity of circuit diagrams is absent from software and programming questions and answers. Having an integrated diagramming tool makes things easier, not harder. Commented Sep 17, 2015 at 14:55
  • This is, assuming everyone knows UML. Hobbyist programmers are less likely to know UML than hobbyist EE-ers are to know circuit diagrams. Those diagrams are like the API to your hardware, whipe UML is a tool you usually only learn about in school, or at your job.
    – Cerbrus
    Commented Sep 17, 2015 at 15:30
  • 1
    Having people come to your desk and talk it through is generally better too. The point is whether the benefit to stack as a whole is worth the developer's time in implementing it? Or would that time be better spent on other projects.
    – EBGreen
    Commented Sep 17, 2015 at 15:31
  • @EBGreen: that's what I was trying to say, yea.
    – Cerbrus
    Commented Sep 17, 2015 at 15:32
  • "Having people come to your desk and talk it through is generally better too." Thus the rubber ducky. It works just as well if you have to write it down nicely, and then you can add drawings too - if it's easy to do. Commented Sep 21, 2015 at 15:39
  • meta.stackoverflow.com/questions/289817/… Commented Sep 21, 2015 at 19:13
  • Not to mention performance concerns. MathJax was turned down for this reason. meta.stackoverflow.com/q/252282 Commented Dec 16, 2015 at 14:47

3 Answers 3

9

I disagree with this request.

I've rarely seen any questions that can't do without UML diagrams. In those cases, if there has to be a diagram, a screenshot of one works just as well. I don't see how the effort required to implement this would be worth it.

For EE on the other hand, circuit diagrams are often crucial to explain what's (supposed to be) going on.

7
  • It's true that you can do without UML. But I think that if we are to encourage judicious use of UML as a lingua franca, barriers to entry are unhelpful. Adoption of UML forces a clearer view of what's going on - whether you talk about class inheritance trees, or state transitions, or interactions. Sometimes just attempting to draw one immediately points out where the problem is. I'm as far from an enterprisey UML-everywhere proponent as it gets, but UML is a very concise and visual way of expressing quite a few things that are much harder to get across in writing, especially with ESL issues. Commented Sep 17, 2015 at 14:51
  • 1
    @KubaOber I don't think anyone's disagreeing that UML is a good thing, but you can do all that with gliffy and take a screenshot - what's the benefit of having the tool embedded in SO? Is it just to avoid that step of saving then uploading the image manually?
    – Clive
    Commented Sep 17, 2015 at 16:19
  • @Clive Whatever argument you have is the argument for not integrating CircuitLab into EE stackexchange, I think. The only benefit of the integration there is that you don't have to copy/upload images manually, and that the schematic is editable. Same would be here. And your argument would also apply to math stackexchange: we can all be copy-pasting screenshots from latex output... Commented Sep 17, 2015 at 16:47
  • Let's recap: Math SE has integrated their lingua franca: expressions, EE has integrated a circuit editor, SE & Programmers should imho integrate a diagram editor. Heck, probably all sites could use diagrams, so this could be site-wide. Taking apart the syntax of a sentence in some language that has its SE site? Use a diagram. Talking of some DIY gizmo? Draw it. And so on. The integration increases the likelihood of visual expression by an order of magnitude or more. IMHO we should be all for such integration. Commented Sep 17, 2015 at 16:50
  • 2
    I'm still not convinced. I just think the use case is way too small to justify implementing something this significant. Yout usage examples hardly apply to stack overflow. SO programming questions are mostly just bugs and simple logic that really doesn't need a diagram to explain.
    – Cerbrus
    Commented Sep 17, 2015 at 16:55
  • Er, who's arguing? Chill, my friend. I just wanted clarification on your feature request, I'm not for or against it yet. Maybe linking to a few examples of great questions that could have been made even greater, or poor questions that could have been made good, by even including any UML at all, would help your case? Once that's established it'll be easier to talk about a problem that needs solving
    – Clive
    Commented Sep 17, 2015 at 17:03
  • 2
    Yeah, what @Cerbrus said. I mean, I do remember on occasion seeing a question and thinking "wouldn't mind seeing a class diagram for this", but it's not the norm in my own experience. Your experience is obviously different, so it would be interesting (for me anyway) to see the types of question that would routinely benefit from this feature
    – Clive
    Commented Sep 17, 2015 at 17:08
2

Found this while thinking of requesting the same thing and I strongly agree with the suggestion.

It might be too difficult to integrate though, can't argue with that.

Now the standpoint from which I'm looking at this is not so much like, "It's too hard to draw a diagram outside and upload a screenshot."

I'm looking at it more like this:

If we had this tool right out of the box, under our fingertips when typing answers to a question, we might use it more often, leading to higher-quality content all throughout the site. It might lead to more pearls which might have otherwise been duds.

I'm looking at it from the meta standpoint of trends and forecasts for human behavior (which is always how I'm looking at things). There are so many questions that benefit from a visual answer, whether it's a beginner question asking about what a piece of code does to a singly-linked list or whether it's an advanced design-related SE question.

While I agree with Cerberus' logic here:

I've rarely seen any questions that can't do without UML diagrams.

... I recommend looking at it more like, "How many questions could benefit from a visual answer? How many cases are there where an image might illustrate a concept better than a wall of text, e.g.?", and there's actually quite a large number of questions that could fit that category, especially when we're dealing with a beginner who still has a hard time even understanding pseudo-code. I taught CS long ago and it would have been hopeless without a whiteboard to draw on when a student asked me a question.

So my thoughts behind this kind of integrated feature is that it might start encouraging more and more people to often include visual diagrams in their answers. It might even save them time and effort while improving the quality of their answer to have this tool always available at their fingertips.

Again, since this feature wouldn't be implemented by me, I can't argue from a cost/reward perspective, not understanding the cost. But it definitely does seem to have a potential for a very high reward. A lesser form of this suggestion is just have a button in the editor that directly links to gliffy, e.g.

1
-7

I am voting for diagram support - especially tools that follow the "diagram as code" idea.


I'm answering questions about Apache NiFi. And it's a visual dataflow tool where we are talking about diagrams and not the code...

I am really missing a simple way to publish a diagram.

Currently I'm using PlantUML as a way to publish a simple diagram. For example: Nifi - Dynamic attribute in the flow

https://www.plantuml.com/plantuml/uml/ENCODED-UML-DIAGRAM - URL to edit your diagram
https://www.plantuml.com/plantuml/png/ENCODED-UML-DIAGRAM - URL publish your diagram

And to insert a diagram into your answer, the Markdown content looks like:

[![State diagram][1]][1]

  [1] https://www.plantuml.com/plantuml/png/ENCODED-UML-DIAGRAM

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .