之前去了一家公司面试,中间聊到了一些项目管理的事情。
目前我所在的公司并没有一些成熟的管理模式和规范的文档,所以当谈到这个的时候,我如实的回答了我目前所在公司的情况。
我仍然对此很感兴趣,一个成熟的项目,有一个好的管理与规范的文档,不仅仅是对项目的后期维护,新需求开发、改版等都很有帮助。
之前我一直认为接口文档是由后台来书写的,所以我对这方面没有太大的兴趣。
面试的时候,面试官告诉我,你进来之后可能会要求你来书写规范的接口文档。
他大概讲解了一些,书写接口文档大概需要如何书写:
一、接口的功能
二、接口所需要传递的参数
三、需要将接口返回的字段 使用的地方列举出来。
原因是为了后续如果离职能更好的交接。
突然想到,目前我所在的项目,接口都是由服务端返回,我们并没有做任何沟通,只是,任凭他去猜测我需要什么字段,然后返回什么字段。
如果有缺少,我会通知他在补上这个字段。
这样的缺点暴露无遗,首先是接口返回了相当多的字段,连我自己都看的眼花缭乱,自己是去找自己想要的那一千个中的一个东西。而且随着时间的推移,接口字段变得越来越多。
而且没有明确的规范文档,项目后续的交接与维护,真是无从下手与头疼。
在面试中,也问了一些iOS推送的第三方和原理。
包括OAuth1.0和2.0的区别。
-------- 学无止境 ---------
目前的项目基本都是成熟期,让公司同意我去重做项目的可能性为0.01,毕竟目前所在项目的代码都比较乱,后台的接口也是胡乱传递,就像垃圾漫天飞世界末日的感觉。
不过可以假设一下如何去着手一个新项目。
从项目功能的角度,思考一下项目整体的框架,使用到的功能。网络是核心模块不可缺少!
根据界面展示的东西去思考,我每一个界面所需要的字段,尽量去减少字段。书写规范的文档,交给后台,由后台去完成接口字段的返回。
这样的做法就大大减少了模型的属性和接口返回的字段。
也可能使文档易读性更高。