从过程到进步:作家如何立足技艺

我不能说我一直想成为一名作家,这只是部分正确。 我一直喜欢做的是阅读并让我的想象力飞涨。 阅读一切,从杰克和吉尔到三只小猪再到小鹿斑比; 莎士比亚,艾米丽·狄金森,保罗·劳伦斯·邓巴,玛雅·安杰卢,读书成为了一种逃脱,使我从小学到高中乃至整个年轻的成年生活着迷。 我想成为写作精英的一员会表现出来。 它没有发生,至少在我对写作生涯的设想中没有发生。 固执己见的“实践使之完美”变成了一个好妈妈,并获得了那些“真正的”工作,我将继续保持读者的身份,但是,尽管图像充斥但积极地练习我的写作技巧,无疑是一个休假。 我告诉自己,写作可以等待。 等一下,它做到了。 我快40岁了,发现自己是一个空巢箱,住在一间三居室的公寓里,没有带白色栅栏的房屋,也不再与穿着闪亮盔甲的骑士结婚。 当骑士变成蟾蜍,高中毕业后孩子们离开家,而我在大都会医院工作的20年破产时,我不是一个快乐的露营者。 近一年来,我一直在看肥皂,吃甜食并为我的情况指责上帝。 我的“ aha”写作时刻是在我看到一个Oprah节目时发生的,这位计算机书呆子正在教她如何变得精通互联网。 在技​​术时代,我有点傻瓜,但当时是佳能打字机的骄傲所有人。 我上大学的儿子离开了他的电脑,当她停下来时,我I着女儿教我基本知识。 2000年,我回到兼职护士,开始认真写作。 当我以为自己永远都无法掌握Word文档,附件甚至保存我的文件时,我并没有精打细算。…

API文档的最佳做法

API现在是其游戏中的佼佼者。 市场在增长,产品正在开发和改进。 这意味着API文档也将成为未来几年的关注焦点。 由于该领域的特殊性,API文档是非常独特的产品。 因此,我们可以推断出一些主要原则,以改进该特定领域的用户指南。 有了适当的文档,产品就会得到更好的采用,从而不会在客户留言中泛滥技术支持; 对业务的总体影响严格是积极的。 进一步,您会发现一些建议,可以帮助您创建高质量的API文档。 这篇文章详细介绍了如何组织API文档的技术编写过程,如果您正在寻找有关API用户手册中应包含的内容的指南,请参阅此博客文章。 让作家写作 我们已经解决了这个问题。 专业技术作家会创建最佳的用户手册,因为这是他们的工作,并且他们拥有正确的工具,并且对帮助创作过程有更深刻的理解。 但是,API是一个难以描述的主题。 它附带了您应该知道的所有术语,例如端点,方法,请求,JSON,Git等。因此,开发人员发现自己编写文档更加容易,因为技术作家似乎资格不足或不完全了解该主题。 让开发人员创建API文档似乎不太麻烦,但是将来会付出很多代价。 如果用户在理解如何使用产品时遇到问题,那么产品的好坏并不重要。 因此,很明显,技术作者应该创建API文档,但是考虑到复杂性,我们如何安排呢? 双向合作…

向父亲致敬:悲伤之旅

图片来自Yoga Basics 我在父亲之前见过棺材。 因此,看到另一个问题并没有什么大不了的,只是问题是我直到我不再爱我的父亲去世,才知道我去世的现实。 向我的父亲(在2007年9月4日去世)致敬,这使他回想起了满满的回忆。 是我用其他东西代替我陷入深深的悲伤和沮丧的记忆吗? 还是听到人们谈论我在中学时的父亲,而我却几乎没有贡献或根本没有贡献-显然是因为爸爸不再了? 在写这篇文章时,我想知道我想真正关注的是什么,因为我去年曾在一篇长文章中谈到父亲,我简直不敢相信我曾写过一篇文章《深度》。 你可以在这里阅读它 https://www.facebook.com/OlolaAfola/posts/10214315990761921?__tn__=KR 因此,如果您从上面的链接中阅读过,您将知道我父亲是个好人,太好了,不能离开–仍然如此。我很感谢他活了下来。 在遗产方面,我在去年发表致敬后签入,对有人写关于我父亲的评论感到很沮丧。 我什至不知道的事情。 例如, “对义人的记忆永远存在。 我记得当时他以每月#10,000的津贴将大学生安置在教堂里,并且他通常在一周内下班直接去教堂。 我还记得他加入我们除草教堂时,我们很快以为这很奇怪,所以我们都试图克制他,他的回答是我应该得到自己的短剑,因为我们都在以不同的方式来进行天上的比赛。 此后几个月他死了。…