One problem with releasing open-source components is that code is not the only thing you should care about. Without a decent documentation no one is able to use your component. Sad to say we are guilty as well, e.g. the documentation for Disco our annotation-based PHP Dependency Injection container lacks in in-depth documentation.
Luckily there are people like Reza Lavaryan who love to dive into code, play with it and create in-depth, real world tutorials like this one found at sitepoint.com covering how to use Disco with some of the Symfony components. You can even find the code for the tutorial on GitHub, just in case you want take a deep dive into the code first. Needless to say I am happy that this tutorial exists as it provides a good starting point. Next up for us is to improve the documentation quite a bit. If you want to help out feel free to ping me.