Questions tagged «writing»

8
您如何撰写技术博客?[关闭]
我通常会阅读很多有关编程的资料。当我阅读的主题与我的工作没有直接关系时(例如阅读一些我在日常工作中不使用的算法),我会忘记它们。 加强已学知识的一种方法是编写博客。我是写博客的初学者。当我开始写作时,我发现这很艰难。即使简单地复制内容也需要大约两个小时。写一篇关于博客的好书通常需要一整天,有时甚至是一个周末。 这正常吗?有编写技术教程/技术博客的提示吗?
27 writing 

5
我应该用什么语法时态写规范?
我们目前正在以两列格式编写功能和技术规范;摘要句子和技术细节。细节通常是指带有图表,布局设计等的附录。 但是我正在努力用什么时态来写它: 以过去的时态好像工作已经完成了,我努力地展示出现有工作的重点扩展。需要完成的将来时态X听起来很像一个待办事项列表或时态中立,因为它要么已经完成,要么已经完成。 更进一步的混淆是,英语不是第一语言的人们可能会阅读本规范。

1
如何快速有效地编写功能说明
因此,我只是在这里阅读了Joel的一些精彩文章。(写于2000年!!)我阅读了全部4部分,但是我正在寻找一些系统的方法来编写我的规范。 我是唯一一个孤独的开发人员,他为一家非常著名的金融公司从事这个相当复杂的应用程序(或应用程序系列)。 我从来没有做过这么严重的事情,我开始写一些类似糟糕的规范之类的东西,这浪费了我很多时间。 我还为客户制作了3个样机样的东西,所以我对他们想要的东西有很好的了解。还发布了预览版(带有最基本工作流程的废弃应用程序),并且我仅编写和测试了一些非常核心/基本的系统。 我认为到目前为止,我一直犯的错误不是写详细的规范,所以我现在就开始做。 所以整个事情包括 MVC网站(用于管理员和数据查看) 2个Silverlight模块(用于2个特定任务) 1个桌面应用程序 我的时间,资源都非常短缺,需要快速完成此工作,还需要确保这些人同样快速,轻松地阅读。 那么如何做我去一下,我正在寻找任何提示,任何现实世界的东西,怎么做你们平时做呢? 您是否对每个对话框/表单/页面都进行了模拟筛选? 我正在考虑制作一个虚拟的ASP.NET Web窗体项目,然后在文件夹中填充HTML文件并使它看起来像我的MVC URL结构。 然后在网站的规范中列出一个部分,并为我与Screenie在一起的每个URL编写一个页面。 对于我赢窗体应用程序,我做了有些演示赢形式的项目,我会再放入一个对话框或结构的一切,我会在真正的应用程序,然后截屏呢? 对于这个问题有一些背景知识。我一直是一个疯狂的跳到代码的家伙,工作正常,但对于我正在开发的应用程序,它不仅复杂,而且对于一家非常知名的大型公司来说,我必须得到它对! (到目前为止进展顺利,今天我给出了很多人喜欢的预览版本的演示!= D) 如果我确实获得了最初的设计权利,那么我将对该公司也有一个不错的生意,已经有很多人在考虑新的“很棒的”功能,他们准备为此付费。

12
可怜的作家会变成可怜的程序员吗?[关闭]
按照目前的情况,这个问题不适合我们的问答形式。我们希望答案会得到事实,参考或专业知识的支持,但是这个问题可能会引起辩论,争论,民意调查或扩展讨论。如果您认为此问题可以解决并且可以重新提出,请访问帮助中心以获取指导。 8年前关闭。 我正在阅读彼得·塞贝尔(Peter Seibel)的《工作中的编码员》,很多时候都提到不能写的程序员通常会变成贫穷的程序员-道格拉斯·克罗克福德(Douglas Crockford),约书亚·布洛赫(Joshua Bloch),乔·阿姆斯特朗(Joe Armstrong),迪杰斯特拉(Dijkstra)声称只读了一半的书)。 您对此有何看法?无法用英语等自然语言表达自己的意见会妨碍编写好的代码吗?
16 writing 

6
您如何使电子邮件简短而完整?[关闭]
关闭。这个问题是题外话。它当前不接受答案。 想改善这个问题吗? 更新问题,以使它成为软件工程堆栈交换的主题。 5年前关闭。 我是喜欢写作和解释的奇怪的开发人员-电子邮件,规范,如你所愿。我乐于帮助人们深入理解事物。我讨厌乒乓球通讯,因为小组中有25%的人误解了以前那封破折的电子邮件,其中作者只解释了一半的位置,或者匆忙而写错了,因为小组中有30或40封电子邮件,电话和会议批评性的字眼,或排除否定的一两个字。 此特征非常适合用于文档记录,但是我的电子邮件很长,因此人们根本不阅读它们。我使用的一些策略是将长电子邮件格式设置为附加的Word文档,以鼓励人们将它们视为文档(有时效果非常好),或者尝试使用更多的项目符号代替免费的段落。这些策略增加了读者群,但是内容仍然很长。 当然,我想大声疾呼,复杂的技术主题需要大量说明和澄清,但这对任何人都没有帮助。显然,可以进行权衡取舍,但我很难证明做出的陈述不明确,否则以后将引起一百万个问题,误解或增加“条款和条件”。 您如何保持简短而完整的沟通?
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.