V4N4D1SJan 31, 2024
Oh no.
Show threadDag Ågren ↙︎↙︎↙︎Jan 31, 2024

@V4N4D1S Don't get me started on how it is 20 fucking 24 and we still can NOT, under ANY CIRCUMSTANCES, put a PICTURE in a code comment.

Because clearly no code has ever needed a DIAGRAM to explain it. That would be utterly useless. Besides, it's not like computers could handle it.

Show threadO'SchellJan 31, 2024

@WAHa_06x36 @V4N4D1S Markdown, github flavored, has it (if not markdown at all).

You can put a comment that direct to a section in a .md somewhere in your repo

Show threadDag Ågren ↙︎↙︎↙︎
@OSchell That's not in source code though. I can put a .odf file in my repo as well. I want picture *in the source*, so I can see them while I am working on the code.
Jan 31, 2024 at 7:21pmWeb
Show threadPusher Of Pixels (old account)Jan 31, 2024
@WAHa_06x36 @OSchell ASCII art ftw!
Show threadDag Ågren ↙︎↙︎↙︎Jan 31, 2024
@pixelpusher220 @OSchell Not writing my documentation with a feather quill, and not making my diagrams with ASCII art. It's 2024! It's just utterly ridiculous that the state of the art of code formatting is stuck in 1980!
Show threadLRFeb 1, 2024

@WAHa_06x36 @pixelpusher220 @OSchell well, it's damn useful that you can just cat and grep in code, and markdown is a pretty good compromise between machine and human readability.

there's several markdown extensions that can turn ascii art into diagrams. one of which is this one:

https://support.typora.io/Draw-Diagrams-With-Markdown/

Draw Diagrams With Markdown

Precondition Sequence Diagrams Sequence Diagrams Options Flowcharts Mermaid Sequence Diagrams Flowcharts Gantt Charts Class Diagrams State Diagrams Pie Charts Requirement Diagram Gitgraph Diagrams / Commit Flow C4 Diagrams (plantUML compatible) Mindmap Timeline Quadrant Chart Sankey diagrams ZenUML XY Chart Global Mermaid Options Overview Diagram Alignment Mermaid Theme Auto Numbering Flowchart Curve Gantt Padding Inline Mermaid Config Save-as / Copy on Diagrams Precondition Typora supports some Markdown extensions for diagrams, to use this feature, first please enable Diagrams in Preferences Panel → Markdown section. When exporting as HTML, PDF, epub, docx, those rendered diagrams will also be included, but diagrams features...

Show threadO'SchellFeb 1, 2024
@lritter @WAHa_06x36 @pixelpusher220 Yep, there should an upgrade on the standart of Markdown. I believe it's one (if nit the) must underrated text format ! (Btw typora is really great, you should get a license)
Show threadLRFeb 1, 2024
@OSchell @WAHa_06x36 @pixelpusher220 i would rather gouge out both of my eyeballs with a dessert spoon than to render myself dependent on software that i don't own
Show threadO'SchellFeb 1, 2024
@lritter @WAHa_06x36 @[email protected] in this case Zettlr is also a very good one... As long as Typora isn't doing shitty things, I'm going to stay w/ it but if it where to happen, I'll make the switch without regrets.
Show threadAlexander The 1stFeb 1, 2024

@WAHa_06x36 @pixelpusher220 @OSchell You will stop me from editing the source file in a plain text editor by prying Notepad.exe/Notepad++.exe from my cold dead hands.

In the meantime, you can do Kanji Art if ASCII Art isn't your style.

Show threadPusher Of Pixels (old account)Feb 1, 2024
@AT1ST @WAHa_06x36 @OSchell id think the source comments could have some sort of formatted link that an IDE plugin would process and display if found. Allows the actual source to be plain text while allowing updated functionality if desired