2.11.0-M8 announcement

[adriaanm]

created from https://github.com/scala/make-release-notes/tree/v2.11.0-M8, with:

sbt -Dfile.encoding=UTF-8 console
scala> MakeReleaseNotes.genPR("2.11.0-M7", "2.11.0-M8", "2014/01/28")

sanity checked (after sudo gem install maruku):
maruku --html 2014-01-28-release-notes-2.11.0-M8.md

ready to be merged -- review by @sjrd or @heathermiller

[adriaanm]

I installed maruku locally to verify the comment at the top didn't break anything

[sjrd]

LGTM.

[heathermiller]

So that comment will likely break the site again when we add a new news item.

[sjrd]

Oh, I did not understand correctly the issue the last time, then :-s Sorry, I will remove it.

[adriaanm]

I noticed the formatting issue with the comment locally. When i moved it up, it was no longer broken, so i assumed that was enough.

[heathermiller]

Something odd happened here: https://github.com/scala/scala-lang/blob/master/_includes/news-feed.html#L55

I'm not certain (I'd have to rollback and recreate the working tree when @sjrd was having issues) but I think that the strip_html might have correctly stripped all HTML while incorrectly leaving the HTML comments. Then, the truncate_words bit caused the HTML comment to be truncated in the "recent news" section, resulting in a poorly formed HTML comment. (I think, if I remember correctly)

[heathermiller]

So the last time, the problem moved to the first item in the "recent news" sidebar after a new news item was added, resulting in an open and dangling HTML comment. It seems like an oversight on jekyll's side. I'd have to look into it – maybe a newer version of jekyll would fix it.

[adriaanm]

Submitting a follow-up PR to remove the comment and fix other minor issues.

[heathermiller]

@sjrd already removed the comment. New idea though, yaml front matter that contains your comments and todos? :/ Might be weird, but def wouldn't break jekyll.

[adriaanm]

on the topic of yaml front matter: my editor syntax colors the last --- differently based on whether it's preceded by an empty newline (red when there's none, blue when there is one)