68得票4回答
Mogenerator参数如何工作?我可以通过Xcode发送哪些参数?

Mogenerator的帮助信息非常少。所有这些参数都是干什么用的?

67得票4回答
Doxygen与Javadoc的比较

我刚从CACM的一篇文章中意识到Doxygen也可以与Java(以及其他几种语言)一起使用。但是Java已经拥有Javadoc工具。请问有人能够解释一下两种方法的优缺点吗?它们是否是互斥的?是否有适用于Doxygen的Maven插件?

67得票7回答
一个 .Net 项目(Sandcastle)的命名空间文档?

我一段时间以前开始使用Sandcastle为我们的一个项目生成文档网站。它运行得非常好,但我们一直只为项目中的类、方法、属性等编写文档,并分别为整个项目和项目部分/模块/命名空间编写完全不同的文档。如果我可以将这些文档合并在一起,并向生成的帮助文件添加相应的文档,那就太好了,但我不知道该如何操...

67得票8回答
生成 Protobuf 文档?

有人知道一款好的工具来使用.proto源文件生成Google Protobuf文档吗?

66得票2回答
XML代码注释中泛型类型的引用

据我所知,在C#类型/方法的XML注释中,可以使用<see>标签来引用泛型类型:///<see cref="name.space.typename<T&rt;(paramtype)"> 但是我想还有另一种语法,它更简便一些? 有什么方法可以摆脱那些...

66得票8回答
为什么Ruby文档中的方法前面有一个井号(#)?

当我看到任何 Ruby 方法在文本中打印时,通常会显示为:Class#method 或者#method 现在,我会使用:Class.method 为什么所有的 Ruby 方法都以井号开头?这有什么原因吗?

65得票3回答
如何使用Python dataclasses为类记录构造函数?

我有一些现有的Python 3.6代码,想要迁移到Python 3.7的dataclasses。我有__init__方法并配有详细的文档说明,指定构造函数的属性和类型。 然而,如果我将这些类更改为使用Python 3.7中的新dataclasses,则构造函数是隐式的。在这种情况下,我该如何...

64得票6回答
记录Node.js项目

我目前正在使用JSDoc Toolkit来记录我的代码,但它似乎并不完全适用于描述命名空间。假设你有两个简单的类,分别在它们各自的文件中: lib/database/foo.js:/** @class */ function Foo(...) {...} /** @function ......

64得票3回答
在典型的Maven项目中,项目文档应该存储在哪里?

在典型的Maven项目中,项目文档(需求等)应存储在哪里?标准目录布局介绍页面列出的目录都不是显而易见的选择。

64得票7回答
如何自动化文档化REST API(Jersey实现)

我用Java Jersey(和JAXB)编写了一个相当广泛的REST API。我也使用维基书写了文档,但这是一个完全手动的过程,非常容易出错,特别是当我们需要进行修改时,人们往往会忘记更新维基。 从观察其他大多数REST API来看,它们也是手动创建其文档。但我想知道是否有好的解决方案。 ...