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 :arrow_backward: :arrow_backward: 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

• [x] 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 :okhand: ).
• [ ] 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 :+1:

[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: :+1:]

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

[grayghostvisuals]

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

[stephenhay]

I've added @paulirish's note to both http://www.the-haystack.com/2010/01/23/css3-flexbox-part-1/ and http://www.the-haystack.com/2012/01/04/learn-you-a-flexbox/ (maybe I should also just write a new version of that one).

[incompl]

My article covers the latest spec and is not deprecated. Is it on this list for some other reason?

[stale[bot]]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[stale[bot]]

This issue has been automatically closed because it has not had recent activity. Thank you for your contributions.