这里说的不是开源库,而是指一群人做的公司私有项目.
文档不仅是给python开发的同伴看,你还需要把文档维护起来给安卓,IOS,web以及其他人看,大家在这方面有什么心得?
一般我是我是一个窗口维护markdown,iterm2这边用vim写着代码.
也许平时这也没什么,不过现在我给团队重构代码,业务代码进行的很快(东西不多也不复杂),但是当我连写了5个接口,以及5个小文档结构的时候,已经感觉很机械了,特别是来回切换总是不大舒服...;
现在考虑是否将文档直接维护到代码doc里面然后通过pyment输出,但是怕把代码文件拉的太长(虽然很多开源项目都是这样子的),大家在这方面用过的有啥感受?
或者有没有更好的建议分享下..
文档不仅是给python开发的同伴看,你还需要把文档维护起来给安卓,IOS,web以及其他人看,大家在这方面有什么心得?
一般我是我是一个窗口维护markdown,iterm2这边用vim写着代码.
也许平时这也没什么,不过现在我给团队重构代码,业务代码进行的很快(东西不多也不复杂),但是当我连写了5个接口,以及5个小文档结构的时候,已经感觉很机械了,特别是来回切换总是不大舒服...;
现在考虑是否将文档直接维护到代码doc里面然后通过pyment输出,但是怕把代码文件拉的太长(虽然很多开源项目都是这样子的),大家在这方面用过的有啥感受?
或者有没有更好的建议分享下..
1
Select Language