Laravel 的官网文档为什么不给出完整的代码?为什么有时候好像还不明确指出代码放到什么文件里?
不会是为了文档的优雅吧?给出完整的代码不优雅?追求一个朦胧美?
比如将接口绑定到实现:服务容器《Laravel 10 中文文档》 。官方文档里就几行代码。然后我搜了一下才搜到这个完整的代码:nickescobedo.com/906/how-to-bind-a... 。(不用魔法应该看不到代码。)感觉清晰多了。
感觉是在劝退没耐心的笨蛋。还好我是有点耐心的笨蛋。
文档只是跟你说明,服务容器是什么,服务容器怎么用。 具体代码怎么写,放在那个位置, 这属于你的业务逻辑,跟文档没啥关系。 另一个角度来说, 文档得兼顾各种用户的需求。 我就想打开文档的时候能很方便的找到核心的重要的东西, 不想被一些太基础又无关紧要的内容转移注意力。