e.g. I want to search which release introduce Time.instant, there is no useful version info in the doc, use the search input box on the github release page always no meaningful result, what I expect is I can search the change log easier use my local grep tools.
How to do that?
Okay, I saw the expected result from git log.
But I really suggest we shouldn’t rely on GitHub’s release page to store such important information ONLY.
There already learned a lesson before, gitlab delete my account and all my public projects only because I am a Chinese.
Changelog file has this info as well might be helpful
Well, it would be handy if Crystal 1.19.1 had version information on methods.
Those changelog only available on specified tag, and only describe changes for current tagged version.
Apart from some links, there’s nothing in the current master’s changelog.
We should probably incorporate older copies of CHANGELOG.md into the repository.
And the API docs should certainly show historical information (when a method was introduced, parameters changed, etc.)
I can do this, probably write a crawler to collect it, do you accept a PR for this?
I can write a crawler to fetch each change log. Would you accept such a PR?
Of course, how to organize it is still an question. maybe a folder like change_logs/{1.18, 1.17, 1.16}.md could be an optional solution, that really easy to filter.
There’s no need for a crawler. This’ll do the heavy lifting:
for i in 0.36 1.15 1.16 1.17 1.18 1.19; do git show "upstream/release/$i:CHANGELOG.md" > "doc/changelogs/CHANGELOG.$i.md"; done
Need some polish as well, though. But I think I have it covered.
Thanks for offering, though!