如何写出一篇高质量的技术解决方案文档(一).docVIP

如何写出一篇高质量的技术解决方案文档（一） 在几年前，我在研究定位技术的时候，看过一篇帖子，里面那篇文档的描述性非常好，让人思路清晰并且容易理解，给我留下了很深刻的印象，由于最近项目不是太急，闲来无事就想收集一些比较好的东西，突然想起了这篇文章，但是由于时间久远，当时也没有刻意记忆这篇文章的出处，也许今天它已经沉寂在网络深海，但庆幸的是经过我的努力回忆，通过它在网络中留下的蛛丝马迹，终于找到了它。 在工作中发现了好的东西有时因为工作太忙，在看过了，用过后就忘记了，甚至是没有时间去记录和整理，很庆幸我有一个记忆力很强的大脑，或许因为当时，那些为了找出解决方法的日日夜夜加深了我的记忆。 下面的内容，基本上是针对这篇对我印象深刻的文章来展开讨论的，我会把我比较欣赏的部分一点点的粘出。 Flow for obtaining user location Heres the typical flow of procedures for obtaining the user location: Start application. Sometime later, start listening for updates from desired location providers. Maintain a current best estimate of location by filtering out new, but less accurate fixes. Stop listening for location updates. Take advantage of the last best location estimate. Figure 1 demonstrates this model in a timeline that visualizes the period in which an application is listening for location updates and the events that occur during that time. 哇，突然粘出这么多，很是压力吧！但是这应该是最细的颗粒了，大家可以先不看上面文章里具体的内容，因为可能文章内容不会在这次我们的讨论之中，那我们该讨论什么呢？在后面会详细阐述，follow me。 这篇文章是出自google的官方指导板块，目的是为了帮助开发者开发一个带有定位功能的App，感兴趣的可以查看原文/guide/topics/location/strategies.html。 Google团队考虑到，可能开发人员对让自己的App具有Location Services的功能这点来说变得有点无从下手，对于解决方案的制定有些拿捏不得，甚至在深思熟虑后制定了错误的策略，为了减少上述的情况，并且提高开发人员开发的效率，帮助项目管理者制定更好的策略，于是这篇文章出现了。这篇文档文如其名，叫做—— Location Strategies 你可以把它翻译成定位策略或者定位机制，随你喜好，它是一个复数形式，也就意味着，也许不是一条策略，这非常符合对现实项目中关于策略的定义，如果只有一条策略我们还有什么好拿捏不得呢？ 一篇好的文档标题一定是简洁明了，直达中心思想，在现实项目的运行过程中我们会看到各种形形色色的文档，有的时候，甚至大多数时候，文档的撰写者为了体现出文档的“专业性”，经常会出现冗长拗口的文档标题，这对于文档的阅读者造成了不必要的引导，甚至是误导。 接着往下看： Note: The strategies described in this guide apply to the platform location API in android.location. The Google Location Services API, part of Google Play Services, provides a more powerful, high-level framework that automatically handles location providers, user movement, and location accuracy. It also handles location update scheduling based on power consumption parameters you provide. In most cases, youll get better battery performance, as well as more appropriate accuracy, by using the Location S