Blog

Online doc interface improved

« Back to the Blog

Categories

Feeds

feed Posts feed

comments feed Comments feed

Be trained by symfony experts
Dec 10: Paris (1.1 - Francais)
Dec 10: Atlanta (1.1 - English)
Dec 17: Montreal (1.1 - Francais)
Jan 21: Paris (1.1 - Francais)
Feb 18: Paris (1.1 - Francais)
and more...

Archives

Creative Commons License This work is licensed under a Creative Commons Attribution-Noncommercial-No Derivative Works 3.0 Unported License.

Many impatient symfony users complained that the online version of the book missed the keywords sidebar. We didn't have time to rewrite it for the launch of the online book, but now it is repaired. Google is currently rebuilding its index of our website, so the search box in this sidebar will soon give relevant results again.

We reworked the documentation pages to give faster access to the essential symfony ressources and explain a little what's behind each link. The documentation home is less graphic but more effective. The book chapters are now one click closer from the home page. As for the missing chapters about sfFinder, RSS feeds, emails, sortable lists and a few others, they will be updated to symfony 1.0 and appear as a "cookbook" in the official documentation. In the meantime, you can still read them in the svn repository (be aware that they are partly outdated). You will also notice a new element in the sidebar of the book chapter pages: a quick access table of contents.

We also wanted to inform you that many translation initiatives on the new book have already started, in languages such as Chinese, French and Spanish. "The Definitive Guide to symfony" is a stable version of the documentation, and it will not change much in the near future (except for typo fixes). So that's about the best time to start a translation effort to help spread the symfony word. Check the documentation contributor's guide in the wiki for more information about translating the book.

We received numerous comments about the online book, including typo fixes, and we tried to take them all into account (the pages have just been updated accordingly). We want to thank you all for your encouragements and contributions.

Comments comments feed

gravatar
#1 Pierre Minnieur said 16 minutes later

Great improvement, although I'm still reading the printed version ;) Thank you for your efforts!

gravatar
#2 virtualize said 35 minutes later

big thanks! like me, when programming, lots of people always have the documentation site in one or more browser tabs open and now it's again a pleasure to use the docs.
despite that i got my paper 'copy' yesterday from amazon :)

gravatar
#3 Jamesou said about 2 hours later

Many thanx!
It's my first comment on a news, so again, Thanks a lot!
Continuez comme ca les gars :)

gravatar
#4 forkmantis said about 2 hours later

Thanks so much. I really missed the keywords sidebar.

gravatar
#5 Olivier (chtito) said about 2 hours later

I don't understand... the symfony book is written with a special version of markdown, isn't it? As a consequence, the Chinese version of the book is not processed properly in the wiki. How would I go about to make a doctrine version of the documentation? Does the documentation exist in other (editable) formats?

gravatar
#6 Blue25 said about 4 hours later

Standard question once again:
Will there be a downloadable PDF version of the book?

gravatar
#7 Lucas TS said about 5 hours later

Very Nice,
this is a book content ?

gravatar
#8 François said about 18 hours later

Olivier: Yes, the symfony book uses a superset of Markdown (supported by the PHPMarkdown extra parser). Some of the book syntax (namely tables) isn't handled by the python version. We're seeing if there is an alternative, but to our mind, the wiki is a working place, and the translations will eventually be imported, reinterpreted in PHP and displayed close to the English version.
Besides, Markdown is the only public version.

Blue25: This question was already answered. You can buy a PDF version at our editor's website.

gravatar
#9 vitaille said about 21 hours later

Very Great Job !

Now, I just need to buy the printed book to begin 2007 with a good start !

PS: And for those searching the 0.6.3 online docs : search for my posts on the forum !

There's a link on my site and a downloadable version of the 0.6.3 docs.

gravatar
#10 David D. said 1 day later

you talk about typo fixes, do they concern the paper book ? will you put an errata page on the site for typo or other errors in the paper book ?

gravatar
#11 Todd said 1 day later

Will there be a way to search the book?

gravatar
#12 Pierre Minnieur said 1 day later

Todd: in a previous news they told us that Google is re-indexing the book and the search will be up again as soon as that's finished.

gravatar
#13 Tiago Ribeiro said 8 days later

Wee. Just received my book \o/

gravatar
#14 jhice said 9 days later

Hi there,
Book ordered (there were 2 left at amazon.fr !)
See u

gravatar
#15 halfer said 10 days later

By 'impatient', I think Francois means 'keen and enthusiastic' rather than 'rude and demanding' ;-)

Anyway this is great news. I hope to upgrade to the latest RC soon!

gravatar
#16 lynx said 10 days later

I own the book, having it online as well for FREE makes it so easy if I am some where I do not have the book handy. Most times I purchase the ebook and the hard book....THank you so much for putting the book online for free.