坦白地讲，小编xtt1341十分怀念旧有的文档体系，因为可以精确锁定每一篇how to文章——那是我们在开发过程中的宝典（即cookbook）。

但是，也不能说新版文档体系麻烦，主要还是使用习惯问题，很明显，新版更加照顾初学，减少了“同一个知识点”的文档入口数量。

由于SymfonyChina一时还难以全面收录所有汉化文档，因此给出以下文档阅读建议，希望能帮您加速掌握Symfony基本知识。

关于BOOK 

我们直接把Book给搬到“起步”里了，因为旧版Book很多内容是非常重要的——尽管BOOK被抛弃了，但实际上是被拆分成多篇文档，以“起步/指南+how to”来重新包装了一下。考虑到不重复造轮子，与其换汤不换药式的“追新”，不如把翻译重心放在我们之前没有照顾到的文档上，因此我们直接移植了旧版网站的book内容到6篇起步向导中。

移植Book的过程中，我们将持续对文章进行优化，直到与官网同步。

对于“起步”6篇文字的“了解更多/Learn More”部分，我们还需要一点时间来完善。

关于COOKBOOK 

也就是how to系列了，同样被官方抛弃了——没有一个集中的cookbook入口，全部归到6+23+33的入口文字下。也就是说，62篇入口级文档下面的“乱链”区域，是可以找到各种相关的how to文字的。

需要how to文章，就从文档左侧导航的6+23总计29篇引导文，以及大导航“组件”中的33个组件文档之中的页面底部寻找。可通过文档小目录中的“了解更多”（#learn-more）锚记查看。

6篇起步向导 

基本上可以是看作原Book中的“必备技巧”之翻版。

23个概念名词 

在原book基础上细分出一些门类（可以理解为原cookbook的关键索引大类），各自形成了独立的入口页。同样在每一篇文字下面有“乱链”区域，相关how to都在那里。但要注意的是，官方“乱链”全无规律，各种交叉混排，是真正意义的“乱链”——而一般提倡的却是“分门别类”式的检索，有利于学习效率的提高。

这23个概念名词就是大家检索how to的入口的主力了。

注意，还有两个入口，组件和起步。

33个组件 

Symfony组件因其核心地位而没有受到官网改版的任何影响，只是加载了“乱链”区域，放入了相关的how to文档。至于原有组件的“直系关联文档”，全部被发配到how to文字中，其归属变得不确定起来——官方经常把同一个文档链接，放在66篇入口文字中的多个“乱链区域”。

关于检索 

Symfony使用了Algolia分布式付费检索，达到了毫秒级的体验，而且是输入一个字母就有响应。这对于海量文档来说简直再适合不过，为此Symfony建立了巨大数组索引。

我们可以用angular2来模拟之，但是需要输入至少3个字母才发http。之所以选择angular2是因为可以用后台思维来操作DOM。

其实如果愿意付费，基于Symfony的程序使用Algolia搜索引擎是非常简单的。

待检索功能完成时，说明SymofnyChina基本成形了。（目前正苦于文档转移和重新校对等，还要添加新how to，甚为费时，心爱的ng2不能继续突击学习，真乃憾事也）

以上是我们对Symfony官方文档体系的理解，但这还远远不够。因为学习Symfony一个很重要的点就是google，包括stackoverflow.com和github等，也包括一些国外“领袖级高手”的博客这种地方——这些都需要从google进入，因此要掌握一定的检索关键字技巧，同时要收藏那些有用的页面（应开启浏览器的收藏夹云同步功能），以备不时之需。

掌握Symfony并非易事，我们会尽己所能地给大家提供帮助。

敬请期待。