Notice (2018-05-24): bugzilla.xamarin.com is now in
Please join us on
Visual Studio Developer Community and in the
Mono organizations on
GitHub to continue tracking issues. Bugzilla will remain
available for reference in read-only mode. We will continue to work
on open Bugzilla bugs, copy them to the new locations
as needed for follow-up, and add the new items under Related
Our sincere thanks to everyone who has contributed on this bug
tracker over the years. Thanks also for your understanding as we
make these adjustments and improvements for the future.
Please create a new report on
Developer Community or GitHub with
your current version information, steps to reproduce, and relevant error
messages or log files if you are hitting an issue that looks similar to
this resolved bug and you do not yet see a matching new report.
Created attachment 21026 [details]
Screenshot of the LESS PRECISE heading on the Xamarin.iOS 9.6 release notes
[Release notes] Starting with Xamarin.iOS 9.6, top heading in the release notes no longer includes the version number
## GOOD heading for Xamarin.iOS 9.4 and lower
On the Xamarin.iOS 9.4 release notes , the top heading of the page is:
> Xamarin.iOS 9.4
## LESS PRECISE heading for Xamarin.iOS 9.6 and higher
On the Xamarin.iOS 9.7 release notes  and higher, the top heading of the page no longer includes the version number:
## Possible improvements
If this change was unintentional, then perhaps for upcoming releases the version number can be included at the end of the `title:` metadata item.
If the change was _intentional_, then this bug report can be resolved as "feature", ideally with a brief explanation of the reason. Thanks!
Created attachment 21027 [details]
Screenshot of the MORE PRECISE heading on the Xamarin.iOS 9.4 release notes
This happened when switching the from our old custom html-based file format we used to the new markdown-based template provided by Adrian, where `title` and `version` are split entries.
Indeed the template we use for release notes changed between 9.4 and 9.6 when moving to markdown.
@adrian was it explicitly defined when you created the new release notes template to *not* put the exact version number in the title anymore? (for style reasons).
However I'm not sure it's wanted given that other products keep putting the version number in their title: https://developer.xamarin.com/releases/android/xamarin.android_7/xamarin.android_7.3, https://developer.xamarin.com/releases/studio/xamarin.studio_6.3/xamarin.studio_6.3,
Either we're doing it right and all the others are wrong or the other way around.
I personally think that for extra clarity, the title should have the version number (even though it's what you select on the right hand side menu). It makes it clearer when moving between XI release notes.
ultimately the product leads own the notes so it's up to you guys
if you want to add versioning back in feel free
Ok so it's your call @sebastien but as I said we might want to update our release notes (and the future ones) for coherence with other products and with our old notes (pre 9.4).