search

dart-lang / pub-dev

The pub.dev website
https://pub.dev
BSD 3-Clause "New" or "Revised" License
774 stars 145 forks source link

We're markdown rendering of changelog - some headers with dates, others not #5127

Open kevmoo opened 2 years ago

kevmoo commented 2 years ago

URL: https://pub.dev/packages/vector_math/changelog

See

image

isoos commented 2 years ago

The content comes from the markdown source of the changelog: https://raw.githubusercontent.com/google/vector_math.dart/master/CHANGELOG.md

isoos commented 2 years ago

However, the parsing should recognize the [version] - [something else] pattern, it seems that it doesn't do it properly at the moment.

creativecreatorormaybenot commented 2 years ago

@isoos @kevmoo I want to note that this pattern is not encouraged anymore.

It was (mistakenly) kept in the Flutter plugin templates for a long time, which I only fixed in February of this year (https://github.com/flutter/flutter/pull/76019).

I think fixing it is a good idea as some older packages decide to keep it, however, I think it is way more important to encourage consistency and communicate the recommended style properly.