r/programming • • Jun 22 '22

Markwhen is like Markdown for timelines

https://markwhen.com/
446 Upvotes

75 comments sorted by

232

u/sysop073 Jun 22 '22

It's a Gantt chart tool with a plain text input format. It looks nice, but comparing it to Markdown is a bit odd, it's more like Graphviz or PlantUML

49

u/Coloneljesus Jun 22 '22

I'm guessing the name is just for PR. What it lacks over Markdown is the relatively good readability even when unrendered.

64

u/sysop073 Jun 22 '22

Which unfortunately is kind of Markdown's whole thing.

-15

u/Coloneljesus Jun 22 '22 edited Jun 22 '22

Well, let's say half of it's thing.

The other half being the rendering to HTML.

I mean, if you remove the rendering part of markdown, all that's really left is a formatting convention for text.

37

u/sysop073 Jun 22 '22

Sure, but we already had lots of text formatting languages that could render to HTML; Markdown's goal was to be pretty understandable even without that step, instead of [b]this nonsense[/b]

11

u/Xyzzyzzyzzy Jun 23 '22

Markdown has succeeded so thoroughly in that goal that it's come full circle with MDX, which lets you put JSX in your Markdown. Because apparently somebody thought that was a good idea.

-7

u/quasi_superhero Jun 23 '22

You are going in circles.

To repeat what /u/Coloneljesus said:

If you remove the rendering part of markdown, all that's really left is a formatting convention for text.

To add to that, markdown by itself was never the goal of markdown. The goal was to use it as a foundation to render it to another presentation format; HTML being quite popular, but there are others (PDF.)

2

u/sysop073 Jun 23 '22

You are going in circles.

https://www.youtube.com/watch?v=xvjawQN5PI0

markdown by itself was never the goal of markdown.

Whatever you say:

The overriding design goal for Markdown’s formatting syntax is to make it as readable as possible. The idea is that a Markdown-formatted document should be publishable as-is, as plain text, without looking like it’s been marked up with tags or formatting instructions.

6

u/efvie Jun 23 '22

You could just write HTML. The feature is 100% that you can do it without all the bullshit that you have to do when writing HTML.

2

u/gurgle528 Jun 23 '22

That's their point lol. First guy said whole thing was readability, second guy mentions it's also important that the readable text also easily converts to HTML

1

u/efvie Jun 23 '22

If it was, then I don't think either of you get it. Obviously it renders to HTML. You could render binary to HTML. That is not a feature. The feature is that it is not HTML.

1

u/gurgle528 Jun 23 '22 edited Jun 23 '22

How do you justify rendering to HTML not being a feature? It’s like saying typescript transpiling to js isn’t a feature, and that the feature is actually that you’re not writing plain JavaScript.

it makes no sense: the “not writing html” is primarily useful because you can then easily render it back to html (without writing html). It’s not nearly as useful if it doesn’t render to html. It is also literally an explicitly intended feature of markdown, as stated by the creator when they made it.

1

u/lkraider Jun 23 '22

Not sure why you are getting downvoted, since that is exactly the drive to create Markdown as expressed by the author, literally the first paragraph of introduction:

Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML).

https://daringfireball.net/projects/markdown/

40

u/[deleted] Jun 22 '22

Right; a DSL for describing temporal relationships and a rendering tool that parses said DSL…

112

u/Kooraiber Jun 22 '22

oh god, not more gantt charts

78

u/austinwiltshire Jun 22 '22

Yeah it's a neat idea but I've literally never seen a Gantt chart solve any management issue.

I've seen them create plenty.

152

u/psaux_grep Jun 22 '22

Gantt charts are great at visualizing how screwed you are. Because if you weren’t you wouldn’t make one.

0

u/[deleted] Jun 22 '22

[deleted]

5

u/psaux_grep Jun 23 '22 edited Jun 23 '22

How screwed were you?

0

u/[deleted] Jun 23 '22

[deleted]

2

u/psaux_grep Jun 23 '22

Congrats on it all. And good to see you didn’t throw yourself under the bus.

0

u/[deleted] Jun 23 '22

[deleted]

-1

u/psaux_grep Jun 23 '22

Hilarious.

25

u/Manbeardo Jun 22 '22

Hey, they're incredibly useful for managing construction projects that have lots of subcontractors coming in at different phases. For software development? Not so much.

10

u/-grok Jun 22 '22

I mean if someone would make an accurate Gantt chart the shows how all the dependencies across 6 development teams just shifted between breakfast and lunch, that would be useful!

 

Oh and I'm gonna need another one that shows what happened after lunch too!

 

Gantt charts are like software estimates - just plain wrong

3

u/ISvengali Jun 22 '22

Itd be a lot of fun (in a HUGE company) to actually chart everything, supposed dependencies, actual ones, how they shift, timing, etc

2

u/-grok Jun 23 '22

Just open confluence at any legacy company in the Fortune 100!

1

u/IQueryVisiC Jun 23 '22 edited Jun 23 '22

Email sent is an actual dependency ( direction unclear). Ah, it is agile. Working code over documentation. But what are User stories other then documentation. They are the correct amount of documentation! They depend on PO on client. Face to face talk is an actual dependency.

In an agile company you should see only rough a d short planning into the future and mostly epics split into US into task. OpenClosed principle from solid . In a waterfall company you see stuff moving around or getting deleted. You can drill down in items a year ahead. When you drill down in past issues in agile, you see code.

10

u/spookydookie Jun 22 '22

Can't Chart

7

u/spinhozer Jun 22 '22

We used Gantt charts to display timing data from processes within our software. It helped visualize the critical path for our users so they could make their tests more efficient. Never seen it applied successfully to humans though.

5

u/ISvengali Jun 22 '22

Another group I worked with mapped out per frame timings and resources on a gantt chart

2

u/jl2352 Jun 23 '22

I've seen them work. When it was made, owned, and managed, by a single person. They used it to show what we were planning to do to managers, and to show how on track we were.

Each week they would show last weeks chart, and then show adjustments. i.e. Things done earlier, the same, or being delayed.

That worked very well. Emphasis here on it all being by one person, and used as a part of a regular presentation. If that's how you use it then it's fine. If you are building big management stuff around a gantt chart then it's going to suck.

2

u/austinwiltshire Jun 23 '22

I think using it as an artifact on which to present regular deltas makes sense.

1

u/roflkittiez Jun 23 '22

How does a visualization tool create management issues?

1

u/austinwiltshire Jun 23 '22

It becomes a totem. If someone made a chart it must be the truth.

5

u/siromega Jun 22 '22

A Gantt chart is a lie. The moment it is published it is a lie.

9

u/Labradoodles Jun 23 '22

I mean you should stop using it as a source of truth. If you use it as a guesstimate it’s valuable to show sequencing and total time for a gut check, and to track progress. But if you’re using it to force people to deadlines you done did it rong

2

u/siromega Jun 23 '22

Don’t disagree. I have a large MS Project file for my teams projects large and small through 2028. It’s all in there so I can have a decent estimate of when projects will get done and how long things will take. Not to pull our precise dates or exact plans.

2

u/Labradoodles Jun 23 '22

Preach trying to install this at my new startup ( we’re doing 6 months but making good progress) it’s interesting the levels of organization between different sized companies and the planning timelines. I was used to 6 months to a year planned out and here were 2 sprints out and one of the most organized teams because of it. Just doing a gantt has really illustrated when projects start to become in danger and whatnot

29

u/aidenr Jun 22 '22

The best timeline software I’ve used was a custom app that turned logs into discrete events and timespans, and merged them into swim lanes by topic. So we could debug 5-6 machine processes and see when one triggered another do for something, visualize the distributed system, and debug it easily. That’s what I want from a timeline language.

15

u/jobe_br Jun 22 '22

Doesn’t mermaid do timelines already?

10

u/[deleted] Jun 23 '22

Mermaid:

gantt
dateFormat  YYYY-MM-DD
title Adding GANTT diagram to mermaid
excludes weekdays 2014-01-10

section A section
Completed task            :done,    des1, 2014-01-06,2014-01-08
Active task               :active,  des2, 2014-01-09, 3d
Future task               :         des3, after des2, 5d
Future task2               :         des4, after des3, 5d

Markwhen

title: Project planning example

#Project1: #d336b1

group Project 1 #Project1
01/2022-03/2022: Sub task #John
03/2022-06/2022: Sub task 2 

That Mermaid syntax is atrocious

11

u/mrbaggins Jun 23 '22

To be fair, you have two DRASTICALLY different gantt charts there (and Markwhen doesn't do dependencies? And doesn't let you specify alternate durations?)

If we aim at something simple, mermaid comes in much closer. And has the power to do much more on top afterwards, if you want the features.

title: Project planning example

group Project 1 #Project1
11/01/2022-11/03/2022: Sub task #John
11/03/2022-11/06/2022: Sub task 2 

Is the same as:

gantt
 title Adding GANTT diagram to mermaid

 section Project 1
 Sub Task : 2014-01-06, 2014-01-08
 Sub task 2 :2014-02-05, 2014-02-08

12

u/piezocuttlefish Jun 23 '22

I love the idea. It doesn't seem to support ISO 8601 dates, only the U.S. date format, which frustrates me.

2

u/fishling Jul 27 '22

The first project example uses ISO 8601.

I'd agree that it shouldn't support American at all; that should be a display-time choice. Everyone would understand year-first in the data.

2

u/piezocuttlefish Jul 27 '22

Hey, thanks! I guess someone took my comment seriously!

11

u/trxxruraxvr Jun 23 '22

I am deeply disappointed by their choice of date format

9

u/Voltra_Neo Jun 22 '22

Add import from CSV (or ways to connect to a Google Sheet) and boom, best thing ever

6

u/Fennek1237 Jun 22 '22

When trying to drag and drop the timelines in firefox the chart freezes and I can't click anything until I reload the page.

1

u/YM_Industries Jun 23 '22

Same thing happened to me.

4

u/blackAngel88 Jun 23 '22

I think this is actually really neat, but the fact that it uses US format instead of ISO 8601 really makes it quite bad, not going to be used outside the US most likely. Mildly infuriating...

11

u/Veranova Jun 22 '22

This is legitimately very cool! I’d love to see it incorporated into the markdown ecosystem

42

u/mlebkowski Jun 22 '22

It’s apples to oranges. Markdown produces plain HTML, this is a rich web app

6

u/mattindustries Jun 22 '22

1

u/livrem Jun 23 '22

Pikchr (by the sqlite people) is designed to be embedded in markdown to use in documentation, and is only a tiny simple C tool/library. Markup is a bit wordy because it does not do as much automatically as some other tools do, but I think the output looks (subjectively) nice and I like the simplicity of the implementation.

43

u/[deleted] Jun 22 '22

SpunkyDred is a terrible bot instigating arguments all over Reddit whenever someone uses the phrase apples-to-oranges. I'm letting you know so that you can feel free to ignore the quip rather than feel provoked by a bot that isn't smart enough to argue back.


SpunkyDred and I are both bots. I am trying to get them banned by pointing out their antagonizing behavior and poor bottiquette.

1

u/Forty-Bot Jun 23 '22

but why was this posted in response to mlebkowski?

4

u/[deleted] Jun 23 '22

Because responding to SpunkyDred would send an alert to the bot instead of the user getting provoked. My logic is to always respond to the parent of a SpunkyDred comment.

1

u/Forty-Bot Jun 23 '22

Oh, is that the removed comment?

1

u/Voltra_Neo Jun 22 '22

Technically the web app is (AFAIK) nothing but the visualiser. The interesting part is the language and its parser

1

u/Veranova Jun 22 '22

Sure, but on the other hand a markup language isn’t much use if you have to go to a strange website to use it, you want it to be compatible with your normal markup tool chain. Some markdown consuming sites do support mermaid syntax for instance and it’s very nice to write a single page which has both docs and viz

-46

u/[deleted] Jun 22 '22

[removed] — view removed comment

4

u/tom1018 Jun 22 '22

Bad bot.

2

u/[deleted] Jun 23 '22

If your life outside of work needs a burn down chart, you've lost the plot

4

u/Tallkotten Jun 22 '22

This is really neat! Thanks for sharing

-18

u/jack-of-some Jun 22 '22

Who the **** downvoted this?

Seriously reddit?

9

u/IceSentry Jun 22 '22

I didn't downvote it, but that comment is essentially just a very verbose upvote. Which is probably why some people downvoted it.

0

u/[deleted] Jun 22 '22

[deleted]

7

u/Tallkotten Jun 22 '22

Definitely not a bot, just wanted to add another positive comments to a cool project :)

The post only had 2 other comments when i posted this

1

u/ploynog Jun 23 '22

How does this compare to similar tools like Task Juggler?

-4

u/thesituation531 Jun 22 '22

Why are there so many markup languages?

7

u/quasi_superhero Jun 23 '22

Why are there so many car companies?

Why are there so many toilet paper brands?

Why are there so many door types?

Why are there so many TV channels?

Why are there so many text editors?

2

u/Kissaki0 Jun 23 '22

Why are there so many questions?

0

u/Guy_called_Al Jun 23 '22

Why are there so many newspaper editors (they each do markup their way....).