[swift-dev] Starter project: Convert release notes into something useful

joe joe at polka.cat
Sat Dec 5 14:54:49 CST 2015


I'd be willing to tackle the second problem (the content/design). I saw someone tweet about this file the other day, and it took me a while to find it in the utils directory. It was a great read, but also kind of a pain as one long doc because I preferred to read from the oldest notes to the most recent. I was thinking it might make sense to split it out into separate files based on the release dates, and move them into a subdirectory of the docs directory. For example:

docs/release-notes/2014-10-09-release-notes.md

Or something similar. Thoughts?

-joe

> On Dec 5, 2015, at 12:54 PM, Chris Lattner <clattner at apple.com> wrote:
> 
> We have this document, which captures some of the evolution of swift over time in the form of release notes:
> https://github.com/apple/swift/blob/master/utils/buildbot-release-notes.txt
> 
> We’ve started updating it for behavior changes in Swift 2.2, and think that something like it is important so that when we do a release, we have a way to make sure that sometime important isn’t missed.  Users like to know what’s new :-)
> 
> That said, it has two pretty serious problems:
> - It is missing content on what happened between Oct 2014 and the start of the Swift 2.2 cycle.
> - It is a weird little text file off in an undiscoverable place in the source tree.
> 
> Fixing the former problem is a bit of an archeology exercise, the later problem is more of a content/design problem.  Is anyone interested in tackling either of these?
> 
> -Chris 
> 
> _______________________________________________
> swift-dev mailing list
> swift-dev at swift.org
> https://lists.swift.org/mailman/listinfo/swift-dev



More information about the swift-dev mailing list