[效率提升]如何实现项目的零成本交接
2020/7/9 11:10:01
本文主要是介绍[效率提升]如何实现项目的零成本交接,对大家解决编程问题具有一定的参考价值,需要的程序猿们随着小编来一起学习吧!
- 如何让刚入职的前端同学最快的熟悉项目, 能最快上手新需求的开发;
- 当因为组织结构调整或者人员流动, 项目需要交接时, 如何在最短的时间内高质量的完成交接;
- 如何避免因历史项目迭代中未知的风险而引起的线上事故;
- 如何提高人效, 动态调整各个项目的开发人员;
- 如何实现项目描述文档的持续集成
这些都是前端开发组面临和需要解决的实际问题, 对此, 分享一下我在我们组推广落地的All In Docs
方案, 只需一个眼神, 即可愉快的完成项目的交接
All In Docs
方案用大白话可以理解成加强版的readme.md
, 所有与项目背景需求, 开发测试部署等相关的资料都可以在文档里查询到, 在实践中, All In Docs
方案看似花费时间, 但实际上它不仅提高了交接效率, 也提高了我们平时的开发效率, 其由如下文档组成
项目基础信息base.md
- 项目背景
- 仓库地址
- 访问入口
- 适配的设备, 端,
APP
和OS
版本 Nginx
配置链接Jenkins
链接Agile
链接configuration
链接,cdn
等配置文件- 监控平台链接
- 埋点管理链接
sentry
链接
项目迭代信息changelog.md
- 每次迭代的
MENBER
, 包括PM
,UI
,UE
,FE
,BE
,QA
- 每次迭代的
JIRA
,PRD WIKI
,蓝湖
,API WIKI
,Swagger UI
- 每次迭代的
flow
链接, 以便追踪Code Review
,Merge Request
与Tag
如何运行项目how_to_run.md
- 配置
npm start
一键启动,webpack-dev-server
自动打开浏览器并配置打开的页面的必要的queryString
- 如果需要切源, 配置
.npmrc
文件, 或者在npm scripts
里添加npm install --registry=http://registry.xxx.com.cn
- 如果需要种植
cookie
, 附cookie
的key-value
, 安利edit this coookie
插件 - 如果接口需要鉴权, 附登录链接和各个环境的用户账号密码
- 如果需要配置
/ect/hosts
, 附如何配置 - 如果需要用
charles
, 附如何配置 - 如果需要自定义的
UserAgent
信息, 附如何配置, 安利User-Agent Switcher
插件
各个环境的访问链接links.md
- 包括
dev
,test
,pre
,prod
环境下拼上必要queryString
的完整链接 - 如有后台管理系统, 附各个环境的后台管理链接, 相应账号, 附如何开通权限
- 各个环境的可访问账号密码
- 如果有用到某些
sdk
, 附上sdk
的文档和相关各个环境的appId
项目的文件目录结构dir.md
用tree
和注释对项目的文件目录结构进行描述
带截图的项目各个页面以及业务流程doc.xmind
一图胜百文, 用带截图和文字的的xmind描述项目的整体流程
坑holes.md
- 开发测试过程中以及线上遇到的各种坑, 花费了比较长的时间才解决的, 或者有可能造成线上事故的坑
问题修复记录fixlog.md
- 用户反馈的工单记录, 包括工单链接, 问题原因, 修复方案
待做todo.md
- 项目体验优化, 性能优化, 代码优化, 架构优化的待做列表
- 排好优先级和预期开发上线时间
除了这些文档, 制度上, 每个项目的owner
负责每次项目Merge Request
时审核文档的更新
这篇关于[效率提升]如何实现项目的零成本交接的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!
- 2024-08-29探索内外边距资料:初学者的简单教程
- 2024-08-29网页开发资料指南:从入门到实战
- 2024-08-29响应式布局资料:入门级教程与实践指南
- 2024-08-29移动布局资料:初学者的简易教程与实践指南
- 2024-08-29AJAX资料入门:轻松掌握AJAX基本概念与实践技巧
- 2024-08-29深入浅出:div标签资料详解,助你快速入门网页布局
- 2024-08-29【ROS教程】ROS文件系统和基础架构
- 2024-08-28SpringBoot框架入门与实践:全面SpringBoot框架资料指南
- 2024-08-28Springboot企业级开发资料:从入门到实战的全面指南
- 2024-08-28SpringBoot企业级开发资料:从入门到实践的全面指南