Styled-components-website: Add upgrading guides

[mxstbr]

Looking at our traffic stats, a search for "Upgrading" is our 5th most visited page on the main repo:

We should add an upgrading guide for v1 -> v2 to the website, which would contain this information: https://github.com/styled-components/styled-components/releases/tag/v2.0.0 (it's kinda funny because the _actual_ upgrade is a simple npm install)

We should also make sure that we can add more upgrading guides in the future, i.e. that it's extensible. (v2 -> v3, v3 -> v4, etc) Maybe we should just post our releases on the website? Is it possible to do that automatically based on the Releases page on GitHub? That'd be awesome for sure...

[SaraVieira]

Maybe adding the : https://github.com/styled-components/styled-components/blob/d2d6be5feafdc116a3429e6b6f71f7718c51a8ba/CHANGELOG.md with some text on the top that tells users how to upgrade ?

[SaraVieira]

Using the API show a list of https://github.com/styled-components/styled-components/releases is also possible : https://developer.github.com/v3/repos/releases/#list-releases-for-a-repository

[mxstbr]

That second one sounds perfect, since we usually have more "human-readable" patch notes in the GitHub releases.

[SaraVieira]

Makes sense :)

Should this be a new page in the header ?

[mxstbr]

Don't really know, the header's getting pretty full. Maybe /docs/releases? :confused:

[SaraVieira]

Looking like this ?

[mxstbr]

I guess, though that's kinda weird. Maybe we should just get rid of the "Homepage" link (since the logo links there anyway) and add a "Releases" link at the end after "Ecosystem", that's probably better?

[SaraVieira]

Better ? :)

[kitten]

@SaraVieira Perfect :heart:

[SaraVieira]

Awesome ! I will try to get started on this after work today 🤓

If I don't anyone is welcome to pick up this , it already has a good documentation

[SaraVieira]

This is what I have so far

[kitten]

@SaraVieira looking good :) only thing is that who released it is irrelevant to the reader. The version number and date however are vital 😬

[mxstbr]

Yeah I'd probably even totally remove the person and make the version number the heading?

[SaraVieira]

I know that makes sense but i am sucker for photos 😛

New version:

[SaraVieira]

They all have the same text because I am having a problem with the md component :(

[SaraVieira]

Fixed

[SaraVieira]

closed by #198