在一个更大的组织中的一个相对较新的团队中工作,作为一个附带项目,我正在查看我们当前的文档,以寻找改进/标准化我们的最佳实践/标准的机会。如果完成任务,我们想使用的理想工具是Azure DevOps Wiki(这是AZDO服务,而不是服务器),因为它与我们的其他PM功能一致。我做了一些挖掘,我没有找到太多的资源/模板/指南,可以真正让你开始使用Azure DevOps Wiki。
除了一般的文档最佳实践之外,我们是否可以使用任何有用的技巧/资源来充分利用该特定工具?还是我们应该考虑一个更好的工具?寻找创意!如有任何意见,欢迎反馈。
我要找的是一个模板/资源库,可以用来帮助标准化文档。
官方没有提供任何标准模板或资源。这里有一个特性请求:
允许基于模板创建wiki页面
您可以为Azure DevOps的此功能请求投票并分享您的想法。
但是由于DevOps wiki是基于Azure DevOps存储库设计的,你可以克隆你想要的模板到你的wiki存储库。
您的wiki的存储库url应该是:
https://dev.azure.com/<Organization Name>/<Project Name>/_git/<Project Name>.wiki
使用以下命令克隆wiki存储库:
git clone https://<Personal Access Token>@dev.azure.com/<Organization Name>/<Project Name>/_git/<Project Name>.wiki
PS:
每个DevOps项目都有一个隐藏的存储库,命名为'<Project Name>.wiki
',此存储库不能通过存储库UI列表访问,也不能通过列表存储库REST API列出。。此存储库也不能作为其他公共存储库进行管理。只有'Wiki的安全性"。除非您删除repo中的文件,否则存储库将永久地将所有信息存储在wiki页面中。
wiki的注释部分的实现非常不同,它不是基于git的repo,也没有提供显式的管理方法。如果你不小心在wiki的评论中删除了图片,你将没有任何办法把它找回来。