在这种情况下,将它们分开可能是可以接受的,并且将它们分开可能更有意义。Angular仅用于您的客户端内容,我假设您正在使用Rails作为API或应用程序功能的其他部分。无论哪种方式,它们都在根本上执行不同的任务,因此将它们放在不同的文档部分中是有意义的。如果您想要,可以为文档创建一个“登陆页面”:一个按钮链接到Angular文档,一个链接到Rails文档,这将解决将它们放在“一个地方”的需求。实际上,想出一种使它们在同一个系统中重叠的方法可能不值得努力,并且实际上可能会导致更糟糕的用户体验。
正如前面的回答所述,最好使用两种不同的工具并将它们链接在一起。 我建议从像Apipie或者只是rdoc来记录ruby的东西。此外,我会搜索一个好的js文档生成器。这篇文章比较了四种不同的生成器,而'Docco'似乎有一个称为'Rocco'的ruby端口,甚至可以为ruby和js生成文档。另一方面,JSDoc使您能够将自定义页面集成到文档中(在这里,您可以放置到apipie生成器的链接)。 一般来说,我可能只会去rails API文档,并采用一些约定来评论您的angular代码,因为angular的内容可能没有API可以被系统的其他部分访问,因此只需要一些内部文档。