Howdy All,

One of the main ongoing themes of discussion around Perl Catalyst is to determine a mid to long term roadmap for where the platform is going. Over the past 18 months we've primarily worked on tasks around improving how Catalyst works with its PSGI underpinnings and we've also tried to graft in a number of features that one expects to come out of the box in a modern web framework from 2014. However this work has not addressed a larger question, which is what is Catalyst going to look like 2, 5 or even 10 years from now?

Another theme I hear a lot is that people find it hard to get the kind of documentation they need to go beyond the basic tutorial. Although there's a lot of ad hoc stuff (All the advent articles, and random blogs, etc.) and there's a number of useful code examples on Github it would be great if there was some sort of structured documentation that filled a gap between the introduction tutorial and the source code.

Aimed at both these issues is a new documentation project just getting started: https://github.com/perl-catalyst/Catalyst-Components-Concepts-Cases

This documentation project is intended to help people understand Catalyst in greater detail once they have mastered the basics but still find a lot of stuff confusing. Additionally, once we understand well what Catalyst is today, we can start to contrast what it might be tomorrow. For example, a comprehensive document regarding Catalyst.pm should serve as a good jumping off point for documenting what we'd change to improve matters in Catalyst 6 and beyond.

This project is just an outline right now, and I am hoping to let you, the community, help me identity all the topics we should cover. Feel free to fork the repo and send your pull requests!