Hacker News new | ask | show | jobs
by convalescindrey 1084 days ago
A changelog is supposed to tell you what has changed.

A general greeting/landing page is supposed to tell you what the thing is.

Trouble is if a link to a changelog is submitted to HN. Most people who don't know what the thing is click on it, have no clue what they are looking it, close it again and then downvote the submission.

Submissions for not-widely-known stuff should be a landing page, not a changelog page.

(In other words, this hurl page is kind of a mix between these two which is odd and arguably misusing what a changlog / news announcement page should be.)

2 comments

We've a more "classic" changelog in GitHub [1], I see the blog post as an editorial view of the changelog: highlights of main features/changes with some context.

[1] https://github.com/Orange-OpenSource/hurl/releases/tag/4.0.0

My favourite is landing on a github repo for a project and reads like the following:

    Schmaggle is the new hyperlayer to solve excess Flingles when re-routing Blumbles in non-zero p=np equations.
    Please open a PR if you're interested.
Or something to that effect.