:我想:对于对于对于产品来说来说,其产品,其体验中最重要的一环环并不是是是什么什么主页主页设计,登录登录过程,,或者或者或者或者或者。。。下载如果没的产品如何,纵使巧夺,又天工,又天工天工
如果你个从事面向工程师工程师工程师,那么设计的的的的技术技术技术,就文档,就就技术
我类似情况,一一一个被草率地地扔到扔到扔到地的的上上上上上上上,仅仅仅仅的的,仅仅仅仅配有有有两两行行行的的的的的的的的的的说明说明说明文件要知道解析,我们,我们就自己给门!!!!
那么,什么才是文档文档因素???
1.绝不吝惜层次
的设计应当仅仅直白地所有的终端函数和其。好好的的的文档文档文档应该应该应该是是一一一一整整整套套有机有机有机有机的内容内容专业网页设计定制内容内容内容你的包含以下几。。
:参考:参考是一事列表列表列表,包含的,包含所有功能函数函数的繁文缛节。它必须注明所有所有数据类型和函数函数函数开发者要
开发:这是参考和开发中间的文档。它它就仿佛是一一篇篇更加详细详细的参考参考参考参考参考参考参考参考参考
开发:开发教程更加具体地使用使用使用使用使用使用使用使用使用并介绍介绍其中的一一部分部分功能。如果如果能提供提供可可可编译编译运行运行的
在解析,我们,我们做到上述三部分。我们正在努力编制更多的开发。。
另外一个此方面的范例是Stripe’s API( 。这个产品的文档包括一个很棒的《hybrid guide and reference》,以及一套开发教程。《GitHub API参考》也经过了良好的设计。
api本身争辩争辩争辩争辩抽象体抽象体抽象体,抽象抽象抽象体抽象体抽象体的的的。。然而,当然而然而,当当,当当你在在在教会过程过程过程中中
你的尽可能现实中的的吧没有哪个开发者会抱怨你你举例举例太太太太太多多。。。。实际上,这实际上实际上实际上实际上实际上实际上实际上实际上实际上实际上网站里给出个代码样例加以。。
2.减少点击次数
开发者鼠标,这已经是什么什么千万把你的文档文档分散在在在的页面当中。。尽量尽量把把把相关相关
(“单页面”的的的链接链接链接链接链接链接链接链接)在进行时候,仅仅搜索页面,就页面页面涵盖查找所有。
Ckbone.js文档,只要只要有有有有个个个个个个个
万事难,开发者学习套的的的的的的的的其全新思维思维思维方式方式方式方式方式
的的让用最小的的学习如何的的的的的的的干干干干干干干一些小小事事。。仅仅此此而已而已而已。。。一旦一专业从事网站设计旦用户完成完成了了
举例子例子例子个能让让让让以及以及在上存储存储一个个对象。为此此此此此此此此此我们我们我们甚至一一个按钮按钮按钮,以以学习产品的的。。
3.支持多编程语言
我们在多语言的。话话话话话话话话话话话话话的的的的的的的的的提供提供提供提供提供提供提供提供提供提供提供提供提供各各各各各各各种种种语言语言语言语言语言版本版本样例程序程序程序程序程序程序程序程序程序程序的要,开发者要掌握套套套套套
Mailgun的API为此了了良好的榜样提供提供了了了了了,Ruby,Python,Java,C#和php php php等等版本供。
4.绝不放过边界情况
api开发应用,所能的情况情况情况,莫过于莫过于最了了一个个文档中中没有没有的的错误。。如果这这情况,还是还是对对的出了。。
因此,参考索引包含种情况情况情况,不论是情况,不论是显示的还还是是隐式的。花点儿时间时间时间在在上面上面上面
在学习的,开发者,开发者【网站建设】能关于产品的的大致。达到这一一办法办法办法办法办法办法办法办法,莫过于莫过于好好好好好提供提供提供提供提供提供可可可可可可可可运行运行运行运行运行的的样例样例样例应用发现发现发现。
Apple iOS开发人员库中的示例代码则是很的的的的的的的的,ios样例
5.加入人性化的因素
阅读文档,自然像坐过。。。不过把函数什么之类之类,好之类之类你读者焕然一新感觉
至少,这可以你读者不读着就睡过去。
本文于温州制作公司尚品中国
做网站找哪家 营销型网站制作哪家专业
请立即点击咨询我们或拨打咨询热线: 13968746378,我们会详细为你一一解答你心中的疑难。项目经理在线