Documentation: Some nice improvements

April 13, 2012 · Published by

Fabien Potencier

A month ago, I've talked about some great enhancements we made for the documentation section of the Symfony website. Today, I'm really happy to announce that we have made some nice improvements again.

First, and probably one of the most requested feature for the Symfony website, the documentation is now available as downloadable PDFs; you can download gorgeous PDFs for all Symfony versions and for all available languages (and yes, providing epub files is the next step).

You can even download one big all-in-one PDF with everything included; more than 700 pages of Symfony goodness!

The second improvement was needed as Symfony 2.1 is now right around the corner. On each documentation page, there is a switch button that allows you to change the Symfony version and the language of the current piece of documentation.

Published in #Documentation

Help the Symfony project!

As with any Open-Source project, contributing code or documentation is the most common way to help, but we also have a wide range of sponsoring opportunities.

Comments

Gianluca Merlo said on Apr 13, 2012 at 16:51

Excellent! Do you think to sell a paper copy of this book?

Beau Simensen said on Apr 13, 2012 at 16:54

Wow, looks great! This is going to be super helpful with 2.1 around the corner.

Armin Weihbold said on Apr 13, 2012 at 17:08

That is great news indeed! I have been waiting for this.

Fabien Potencier Certified said on Apr 13, 2012 at 17:22

As requested on Twitter, I've just rolled out a new version where code examples are highlighted in the PDFs as well!

Dorian Villet Certified said on Apr 13, 2012 at 18:07

This is just amazingly good! Thanks Fabien for this feature.

Massimiliano Arione said on Apr 13, 2012 at 18:25

Unfortunately, the recent move of Italian documentation URL broke the images again.
Also, since we spread the old link, could be possible to get a 301 redirectiono from old one to new one?

Fabien Potencier Certified said on Apr 13, 2012 at 19:16

@Massimiliano both are fixed now.

Szymon Szewczyk said on Apr 13, 2012 at 21:39

Awesome!

Peter Kokot said on Apr 14, 2012 at 01:04

That is very usefull feature. Thank you.

Philipp Rieber Certified said on Apr 14, 2012 at 09:48

#10

Great news! Printed stuff is still the best for a day at the beach. No need to worry about a hardware device ;-) Thank you!

Michal Piotrowski said on Apr 14, 2012 at 14:35

#11

Hi,

There is a problem with example code formatting in PDF version. Example code should be wordwrapped.

Best regards,
Michal

Stefan Vogel said on Apr 14, 2012 at 22:42

#12

That's really great. I'd like to take the documentation "offline" with me.

But what I would like even more is the ability to comment on the documentation (as here in this blog).
This would help to clarify some examples, improve the quality and correct errors faster.

THAT would be a feature I'd really like to see!

Peter Kokot said on Apr 15, 2012 at 19:34

#13

Commenting sistem regarding documentation can be done over github with issues. I think this is better.