Cleanup of deprecated flexbox articles on the web

[paulirish]

It's been painful for people who are looking up flexbox to find articles covering the old legacy flexbox. And get foncused.

Nowadays we have a solid amount of documentation for new flexbox as well as strategies for targeting both implementations (and the in-between IE10 "tweener" impl).

So... we can adorn all the older flexbox articles with a big warning/disclaimer that directs people off those page to more updated articles.

I wrote this warning for my old html5rocks flexbox article, but even it's out of date now.

@dstorey and @simevidas and I kicked off a list of these articles:
http://oksoclap.com/p/deprecatedflexboxarticles ◀️ ◀️
I think that's mostly it, but if you have more to add, please do.

Next up.. Let's come up with a recommended disclaimer. There are a few articles out there (starting with Bocoup's guide and Chris's article on targeting both) that we want to point people to. And a few tools like Flexbox Please and Flexplorer. This has sorta been summarized on http://html5please.com/#flexbox

What needs to be done

• Pull together a list of articles covering the old syntax
  • http://oksoclap.com/p/deprecatedflexboxarticles
• Come up with a small list of resources that covers the fundamentals of the new syntax as well as a tri-implementation guide. So probably two-three articles. Then one or two tools. (I'm hoping choosing this won't be too contentious 👌 ).
• Write the prose for the disclaimer. Something friendly.
• Outreach to the publishers and authors to get this bad boy added to the top of their resources.

Sound mostly good? Anyone wanna help?

[grayghostvisuals]

I wrote about it a bit back so I would be happy to update it with the disclaimer. Should have done this ages ago.
http://blog.grayghostvisuals.com/css/sayonara-faux-columns-hello-flexbox/

[simevidas]

Articles about flexbox:

• “Old” Flexbox and “New” Flexbox by Chris Coyier (August 2012)
• Flexbox — fast track to layout nirvana? by Cris Mills (October 2012)
• Dive into Flexbox by Greg Smith (December 2012)
• Flexbox syntax for IE 10 by Zoe Gillenwater (February 2013)
• Using Flexbox: Mixing Old and New for the Best Browser Support by Chris Coyier (February 2013)
• Working with flexbox: The new specification by Steven Bradley (March 2013)
• Advanced cross-browser flexbox by Chris Mills (April 2013)
• Animating flexboxes: the lowdown by Chris Mills (April 2013)
• Designing CSS Layouts With Flexbox Is As Easy As Pie by David Storey (May 2013)

Articles that use flexbox:

• Product Grid Layout by Mary Lou (May 2013)
• Replicating Some Of Google Hangouts Chat Design by Chris Coyier (June 2013)

Tools:

• ptb/flexgrid, flexbox-based CSS grid
• Flexy Boxes, code generator
• CSS Flexbox Please!, demo
• flexplorer, demo

The above content is available as a gist here.

---

I'd make the disclaimer simple. An one-liner, something like: "This article is outdated. Up-to-date information about Flexbox can be found…". The question is, where should the disclaimer point to? Maybe to the HTML5Please info box?

[paulirish]

Okay I tried to best summarize the flexbox state in the html5please flexbox box:
http://html5please.com/#flexbox

[paulirish]

Hows this for a warning at the top?

This article is outdated and no longer accurate. Find up-to-date information about flexbox at HTML5 Please.

[grayghostvisuals]

@paulirish Sounds F2M 👍

[paulirish]

dennis can you try reaching out to all the authors? Maybe ideal to just cc
them into this ticket.

On Tue, Oct 29, 2013 at 12:01 PM, Dennis Gaebel notifications@github.comwrote:

@paulirish https://github.com/paulirish Sounds F2M [image: 👍]

—
Reply to this email directly or view it on GitHubhttps://github.com//issues/124#issuecomment-27275362
.

[grayghostvisuals]

Callin' it in:
@chriscoyier, @chrisdavidmills, @incompl, @zomigi, @stevenbradley, @dstorey, @crnacura