团队文档管理工具

最近所在的组织在思考需求文档如何管理,趁这个机会将自己以往使用过的文档管理一并整理,供大家参考。 需求文档的核心目的在于快速、准确的向相关方传递产品设计理念和方案。易用、快速、可传承、安全与持续维护、成本是选择管理模式的主要维度。 管理目的 需求文档管理可能是产品设计环节产品经理最常进行的工作。我们需要综合考虑各项因素: 易用 快速访问 可传承 安全与持续维护 成本 易用与效率 一个交互体验良好、稳定的管理工具和方式,有助于让文档编写人员工作时可以保持一个良好的心态,而简洁的界面也可以让人员集中注意力编写文档。 我们还需要考虑行业和组织特性:若文档涉及大量计算推导,对数学公式的支持就会变得尤为重要。对于虚拟组织或有网上讨论问题的文化,在线讨论功能就很实用。 快速访问 可传承 基于 web 的产品基本避免了对客户端环境的依赖。 对于较为较为复杂的文档可采用 word 或 axure 等较为成熟的商用软件或者开源软件,有利于避免日后依赖的编辑软件不再维护的尴尬。 但对于很多开源软件,也意味着功能较为单一和文档不兼容,再日后迁移至其它平台(比如上云)或更换其它软件会带来另外的工作量。 安全与持续维护 除了大牌且持续维护的平台,尽可能的不要使用选择互联网管理产品,毕竟组织内文档往往是重要的资产,再谨慎也不为过。 一些大牌的平台往往将更灵活的安全选项设为收费项目,当发展到一定程度(如:出现了多个项目组、较复杂的层级、需要在该平台上管理多种类型的文档)时不妨考虑。 通常也不建议将自行构建或私有化部署的管理平台暴露到公网,通常这类软件在设计都不像那些面对客户的产品那样有完善的安全策略或有足够的运维资源支撑。 成本 尽量采用开源系统 常用工具及管理方式 SVN SVN是一种开源的版本控制方法,拥有版本和分支管理等特性。每个软件行业从业者应当对其都非常熟悉了。通常产品经理们只将其作为版本管理的工具。有如 TortoiseSVN(Win)、 Versions(MAC)等客户端。基本上是0成本的管理工具。 作为最入门的管理方式,可以使用文档编辑工具编写的文档以独立文件形式存在,以一个发布版本为一个文件夹组织,以文件名进行识别,定期(如:每日、归档时)将档案提交至SVN上,以让组织内部其他伙伴可以查看。 GitBook GitBook 是一款与 GitHub 同门产品。是一款专门定位于文档管理的工具。 通过 「编辑 – 检查 – 合并」的工作流程对文档进行迭代编辑,支持 markdown, 内建简单的API文档、Q&A模版。 在内容上支持网页插入图片、公式等。甚至对于接口文档都有内置的内容块,非常实用。 免费版的 GitBook 可以发布一个公开及一个私人空间,还可以指定一个自定义域名(CNAME),作为公开的说明书等公开文档来说非常专业实用。 考虑到软件的持续迭代,GitBook 自带了「 释出版本管理」的功能,方便对同一个产品的不同版本分别维护。当新增一个版本的时,将从标记为主板本的文档中拉出分支。 […]

python 为无列名的数据增加标题

在处理外部数据时,经常会遇到无列名(无表头、无标题行)的数据。以下是从 https://openflights.org/data.htm 下载的全球机场数据: 上述数据没有表头,且数据经常来自外部,直接修改文件加上表头不便于后期数据更新,故不考虑直接修改原始数据源。为了方便后期的数据处理,我们希望能将上述数据加上表头,整理为类似下方的格式。 读取文件时,指定列名内容 read_csv:参数header=None,表示读取的数据不包含表头。pandas会在其第一行加上 0, 1, 2, … ,n 的一行;参数names=airports_colums表示将数组 airports_colums 设置为列的名称 导入后对 DataFrame 进行处理 read_csv:参数header=None,表示读取的数据不包含表头。读取的数据最前面会加上 0, 1, 2, … ,n 的一列。 airports_colums,定义表头的数组。 airports_data.columns,将数组赋予columns属性