Make release notes more machine-processable #1834
Labels
feature-request
A feature should be added or improved.
needs-triage
This issue or PR still needs to be triaged.
Describe the feature
The release notes provided for each daily release of the SDK are useful, but would be easier to scrape change details from if each section was wrapped in a
<div>
block.This change has only minimal to no utility for the majority of people, but anyone trying to automate or create a script to manage information on changes in releases would find it beneficial -- and this change should in theory take very little time. There wouldn't need to be any visible effect of the change, even.
Use Case
I'm working on a script that will scan the release notes for each day's release and add each change listed to a database for use in other tools I plan to create to help me locate when certain changes were made, compile lists of changes affecting specific services, and so forth.
Currently, scripting is somewhat challenging because there is no structural wrapper around each section of content, which means having to locate sibling
<ul>
elements and pulling their contents. There are risks in this, especially if the structure of the content shifts slightly over time.Proposed Solution
By wrapping each section (the
<hN>
heading element and the<ul>
element and its descendants) in a<div>
block -- ideally with an identifying class name, like "release-section" -- it becomes safer to pull each section and its contents, by simply scanning the HTML of the release information for<div class="release-section">
blocks, then pulling from it the text contents of the header and each of the<li>
blocks corresponding to the details on what changed.That information, plus the date listed for the release, would go into the database for scanning and processing later.
Other Information
If I could find the code that generates this, I'd make the change myself.
Acknowledgements
The text was updated successfully, but these errors were encountered: