解析“大睡眠”:三位作家编辑对经典的黑色小说进行注释。

“在某个时候,我们开始思考和写作,这是一种奇怪的炼金术。” 您是如何整体管理项目的? 最明显的是,您是如何划分工作的? Owen:我们召开了一些早期会议,划分了工作,并且有一个简单的模板,但是有很多溢出。 由于时间表相互冲突,身体上很难在一起,因此我们以电子方式处理共享文档。 进行了大量的修改和重做。 在这一点上,我只能将作品的一小部分确定为完全“我的”。我最初担任负责人的注释已被编辑和改进。 在某个时候,我们开始思考和写作,一种奇怪的炼金术。 帕梅拉(Pamela) :有一些明显的专业知识和兴趣领域自然地带我们去了不同的方向-我去了洛杉矶的历史和文化和纸浆,欧文到了好莱坞和犯罪,安东尼到了文学和浪漫主义,但后来我们基本上跨到了一起因为您对小说和自己的研究的投入越多,得到的见解就越多,您的领地流向其他人的机会也就越大。 是的,它变得很血腥! 安东尼 :我们召开了一次会议,在本书的第一季度左右分配了单词和段落。 但是在那之后,它是一种免费的。 早期出现的某些东西继续作为整本书的主题,因此由同一个人接受。 帕姆(Pam)追寻洛杉矶早期历史的脉络。 我在骑士形象,浪漫主题和性政治方面做了很多工作; 欧文遵循呼唤他的语言和政治话题。…

六个非常规写作思想

除此之外,还有常规的文档页面-示例,教程,说明控件支持的数据源,如何对控件数据进行过滤和分组的文章等。小时的问题是这些文章是否应提及所有这些内容。我之前提到的2000多种属性,方法和事件。 这个问题的一个答案是“是”,因为“如果您不全部提及它们,那么用户还将如何了解它们?”从这一观点出发,您正在将文档转变为仅显示一部分API和留给读者去寻找剩余的东西。 我不同意。 鉴于文档中已经包含“ API参考”部分,读者可以自由浏览这堆内容,并为每个可用的公共项目找到描述。 单独的帮助文章则是完全不同的实体。 作为作者,您不应以提及现有API的每一点为目标。 技术作家的工作比遍历Visual Studio的“属性网格”中的属性A到Z更重要。 这让我想起了一个原始人,他使用mo吟声,吟声和壁画在一个部落面前分享他最近的发现-火热,石头折断,猛stick象很强。 相反,有一个故事。 您的工作是引导人们开发复杂的产品-为他们画一条学习曲线。 您的目标不是要提及每个现有成员,而是要说明某个功能的主要用例是什么,可以直接使用哪些功能。 然后添加更多特定的案例,将最高级的特定场景留在边缘,然后将其转移到专用示例和操作方法上。 一言以蔽之,过滤信息并将其分解成几部分,然后根据这些内容构建叙述。 结构 忘记什么是“功能” 多年来,我们一直在编写基于功能的文档。…