先发布还是先发布文件？

我从事一个项目已经有几年了，并且我开始收集一个不错的用户群。我已经创建了一个项目页面，其中包含一些基本文档，但实际上，这仅是一个FAQ。我知道我需要改进它，以便它对新用户和高级用户都提供更多信息，并且这是下一发行版的任务清单中的下一个。

但是，下一个版本具有用户群渴望获得的功能。我已经准备好立即发布它，它已经打包并可以使用了。我只需要将其部署到适当的分发服务。

要点。这些功能对我的用户很重要，但是文档对我很重要。我应该等到重写文档后再发布吗？我当前的用户群足够了解如何使用新功能，因此我不必担心。由于我的空闲时间有限，因此可能需要花费几周才能完成文档，但是如果我让他们再等待的话，社区就会把我烤死。

客户在这种情况下正确吗？对于现有用户而言，梦幻般，直接的功能是否应该优先于针对新用户的强大文档？

更新：哇，这么多优质的回复！您确实帮助我更好地了解了我应该如何与项目及其用户进行交互和支持。太感谢了！

简单：发布测试版！然后，在完成文档编制后，对新版本进行最终发行。

如果您有用户愿意尝试新的东西，那么一定要利用它。您将获得错误报告，可能会向社区提出有关难点的问题，以便您知道将精力集中在文档等上。您可能还希望根据用户反馈来调整某些内容，这可能会影响文档。

基本上，每个人都赢。

不进行早期发布的原因之一是，如果您认为用户不会接受“测试版”，那么您应该三思而后行，但是按您的撰写看来，他们会对此感到满意。

另一个原因是，如果使用您使用的任何发行渠道进行Beta版发行存在技术困难。这样一来，单独进行Beta版和最终版发行可能会比花在麻烦上更为麻烦。如果您认为您的软件是完整的，那么在这种情况下，我将依靠早期发行版，完成后更新文档。否则，存在文档被延迟的风险，然后整个发行版将被延迟，或者您最终最终发布时都没有最终文档，所以现在就做吧。

如果我说对了，那您就是在空余的时间做这个项目，没有钱。如果是这种情况，那么请做一些让您感觉更好的事情（用户等待，请准时记录下来）。您不应该感到来自“用户”的压力。许多人在Internet上撰写了有关此内容的文章（感到压力的大FLOSS作者和贡献者）。

但是，如果您获得报酬或获得一些利益，请执行用户想要的操作。这意味着要做对客户或用户最有利的事情，在这种情况下，只需按时发布并记录即可。您说他们会找到办法的，所以这没什么大不了的。

一般而言，有两种类型的文档：技术性文档，用于对您的代码（类，单元等）进行文档化，以及新功能如何操作以及如何在代码和用户文档中实现。IMO，技术文档是必不可少的，尤其是如果软件开发不是您的全职工作。我花了很多时间在这上面，因为由于终身的承诺，我在编写代码方面可能会间隔很长时间。

用户文档很好，但我认为不是必需的。当然，这取决于应用程序的复杂性，用户群对正在讨论的主题领域中计算机和系统的使用的熟悉程度-在您的情况下，您的客户似乎可以掌握新功能的工作原理。有一种观点认为，良好的用户体验和良好的用户界面需要最少的用户文档。

另外，如果您的时间有限，并且确实感到如建议那样去开发文档，那么您可以制作一些简短的视频，仅介绍新功能。这将使您花费一些时间来编写实际的文档，然后可以填写不太重要的细节。

一些营销技巧可能使您能够平衡用户的期望并仍然可以提升您的品牌。这实际上取决于您到目前为止所创建的应用程序的类型和工作流程，但是您可能会看到新版本的欢迎屏幕，并且在应用程序中，您可以通过提供链接或通过播放应用程序中的视频来显示视频。

不仅要为此特定示例添加一些内容，而且还为常规工作流程添加一些内容：

文档可能是您的definition of done文档，但是文档大部分时间都超出了最低限度的可行产品（MVP）的限制。

客户不仅永远是对的。如果是商业产品，发布可能具有很大的商业价值，并且绝对是当务之急。

所有者定义了业务价值（我认为这是您的价值），那么，对您的客户来说，作为产品更有价值的是什么？

如果没有文档，是否还有释放风险？

例如比赛 ; 如果竞赛在您之前发布了此超级功能，您可能会失去一些用户。

询问您自己或产品负责人这些问题，您的答案将很清楚。

新功能使老用户感到高兴。好的文档会吸引新用户。您应该专注于哪个，取决于您更需要哪个。您表示用户群状况良好，因此可以等待新功能。作为老用户，我也喜欢优质的文档。开源的好处：老用户添加了自己的功能。

您尚未澄清问题，也可能未向用户说明这些选择的后果。您在用户支持上花费了多少时间？其他文档会减少您花费在支持上的时间或增加销售量吗？做文档对您有什么好处？

您的用户想要文档中的新功能，但是他们是否意识到提供支持，修复错误，发布补丁程序等的可用性可能会下降？

如果当我要做的只是向您发送带有问题的电子邮件时，我不花时间去阅读说明，为什么我会想要有关新功能的文档？

如果软件包准备发布，请发布给客户/客户并开始处理文档。当您共享文档以帮助他们了解已部署的功能时，可以很好地与客户沟通。