包含模块本身的文档非常薄,而且往往指向 MOP。
5 回答
首先,如果您还没有阅读手册,则应该通读该手册。然后你可以继续阅读食谱。
我认为这些天的文档实际上非常好,只要您阅读正确的文档即可。除非您对 Moose 的自省功能感兴趣,否则您真的不应该费心查看大多数文档以查找以 " " 开头的任何类名。Moose::Meta
我试图在 Moose.pm 文档中使这一点更加明显,从 0.57 开始,该文档告诉您首先阅读手册和食谱。
如果您来自执行 Perl 5 OO“老派方式”的背景,我还建议您查看Moose::Manual::Unsweetened
文档,该文档将 Moose 与等效的 Perl 5“手动”代码进行了比较。
http://moose.perl.org是 Moose 的一个很好的中心资源
一旦您阅读了 Dave 提到的文档,如果您对它如何变得更平易近人或让您走上正轨(或者更容易找到)有所了解,也许您想将其贡献给文档。开发人员无法真正从新用户的角度阅读介绍性文档。因此,针对文档提交错误报告(可能带有补丁)和/或在邮件列表或 irc 频道上讨论它。这将帮助你的下一个人。
我发现这张Moose 快速参考表非常宝贵。我总是忘记在哪个手册部分查找特定功能。
我也刚刚开始转向 Moose。由于术语“好”可能相当主观,因此我将详细说明我在这些资源中发现的优点。根据您在 Perl 中的技能/经验,这些资源可能或多或少有用。
我从这个Perl Monks 页面开始。并直接进入底部列出的Moose::Cookbok链接。在那里,作者包含了更多指向演示 Moose 语法和面向对象程序的 pod 的链接。订单安排得很好;从简单和基本的 OOP 开始,Moose 在顶部,随着您向下浏览页面,逐步进入更复杂的示例。pod 写得很好,不会过于冗长,并且清楚地解释了代码的每一块。
我敢肯定,一旦您完成了 Cookbook,您就可以查看 Perl Monks 页面上列出的任何其他内容。我仍在浏览 Cookbook 中的示例,所以我还没有检查 Perl Monks 中列出的所有资源,但我确信它们很好。