Current Media documentation is mostly for 1.x with the Media entity and Styles module. New users don't have good documentation for the current 2.x with File entity and Manage File Display workflow, and the legacy docs confuse them.
- Create new Media 2.x documentation.
- Revise old 1.x documentation that is still valid.
- Remove old 1.x documentation that is no longer valid (e.g., with backport of file entity to 1.x, Styles module integration is no longer recommended).
- Push Goal: create video tutorials to link to in documentation.
We have some good content to start with:
Walkthrough by pandaeskimo: http://drupal.org/node/1699054. Great stuff, a real-world example.
Media 2.x configuration overview by RobW: http://drupal.stackexchange.com/questions/40229/how-to-set-media-styles-.... Needs pictures.
Original Issue by pandaeskimo
I have tried to wrap my head around Media 2.0 and have created a tutorial as part of the Media documentation. There are tons of images outlining how to set things up. I'd appreciate any feedback or help building this out.
I will probably be cleaning up our own handling of media files and if I'm going about it the wrong way, feedback would be helpful.
We all know Drupal documentation is often week and the concepts behind using certain modules can be very awkward. Hopefully the workflow and descriptions in the tutorial can help people.