All articles| All Pictures| All Softwares| All Video| Go home page| Write articles| Upload pictures

Reading number is top 10 articles
韩寒“ONE”获6000万元A轮融资:发力互联网 - 韩寒,ONE
Circle of friends for help sending iPhone to bargain, do you ever forward? ,
阿里旅行遭携程、艺龙、去哪儿联手封杀 - 阿里旅行,携程,去哪儿
Samsung’s salary will change: pull over seniority, performance priority,
Man-machine chess battle bosses stand in,
鱼油胶囊无效,代言人姚明遭索赔1分钱 - 鱼油胶囊,姚明
4G比3G更耗手机流量?这是错觉! - 4G,3G
滴滴和Uber摊上事:被北京八部门约谈 - 滴滴快的,Uber,优步
Propaganda does not do head phone party, Chongqing college students want to recruit,
Developer: WebKit will no longer use the non-standard CSS attributes prefix
Reading number is top 10 pictures
身材野火台灣美女1
这才是真正的人体艺术5
两个妞在等世界上最短的火车
美女和狗狗1
The real super beauty13
Thrilling English baby
南昌铁路局宜春车务段攸县车站铁路职工福利房被开发商侵占
人美胸美腿更美2
Sexy women in 2013--1
9.3阅兵全景图7-指挥系统和后勤保障系统梯队
Download software ranking
Unix video tutorial19
Unix video tutorial6
超级战舰
功夫熊猫2(上集)
C++编程教程第三版
Tram sex maniac 2 (H) rar bag11
Proficient in Eclipse
仙剑奇侠传98硬盘WINXP版
Proficient in JavaScript
The cock of the Grosvenor LTD handsome
aaa published in(发表于) 2014/8/12 2:39:25 Edit(编辑)
Code: writing good code and written document,

Code: writing good code and written document,

Code: necessary to write good code, and written documents-programmer, code, code, document-IT news Code: necessary to write good code, and written documents

Summary: whether programmers should pay attention to the document prepared? This is a seemingly small but important issues. Besides programs and data, software, including documentation. Second, if programmers only write procedures, cannot properly and elegantly described in document their thoughts, then there really is "code rural".

Whether programmers should pay attention to the document prepared?

The importance of written documents

For software-related industries, at school, or you may have already noticed, in addition to the program to write, draw, design charts, there is another important task is to write the document. Why write documentation? Because we have to do their own thing displayed, showing not only to peers, staff may want to show to other positions, even displayed to the user. If we just wrote the program not properly and gracefully in a document describing one's own ideas, then become a true "code rural".

I note a bit, does very little of the surrounding colleagues will write a high quality document. Kai-Fu Lee, a teacher in the preamble of the top of the tide, said: "I know a lot of top engineers, but there is a powerful narrative ability of outstanding engineers, I know, can be said to be rare. "It is true that the colleagues I know and be able to articulate their ideas in the document is very small.

Related document writing impressed me question has the following aspects:

We are receiving a lot of emails every day, I carefully looked at, lots of e-mail content or statements are not fluent, or have a lot of typos, misuses or no punctuation marks. Most of the time, from a different perspective, a message that has many different meanings, make people feel does not know what it wanted to express a meaning, which greatly reduces the efficiency of the work.

In addition to the code, the project will also include a large number of documents. Open most documents, seeing at first glance, I have these kinds of feelings: writing is not neat, not in the correct format, statements not fluent, pretentious English. An eye that the authors did not write the document and the statement of strong communication and organizational skills are not.

At the time of project team members to discuss, and almost all of us were talking about how to write programs, but there is no mention in the document writing should do to try to improve. Everyone seems to agree that the developer's job to write programs, and everything else is secondary.

Traditional computer software is defined as: software and hardware is a computer system depends on another part of the software including programs, the complete set of data and its associated documentation. Note that this refers to "related documents", if the document is not written, the software can not be regarded as excellent software. In fact, the software features sound, but because the document cause fail still appears occasionally.

Generally speaking, in the process of software development, main document involved at different stages as shown in the following figure:

Can be seen in different stages of the software, you need to write a different document. In plans stage, needs prepared detailed design document, and unit test programme document and integrated test programme document,; in development stage, is this several document, just amendment version, because we in actual development process in the, will found zhiqian design not reasonable of place or is considered poorly of place, this on needs on zhiqian of document for modify; in test stage, to prepared unit test report, and integrated test report and system test report,; in software of released stage, to prepared installation manual, and user manual, and Upgrade instructions, which are primarily for field support personnel and users, it will try to write more accessibly, never ambiguity exists, otherwise it only waits for user complaints.

If you want to write good documentation, we need first to correct the idea that documents are not important. Where you want to put your documents and programs are equally important.

How to write a high quality document?

So, how do we produce high quality documentation? I think we can proceed from the following aspects:

Change document, supplemented by the concept in everyday work, for each document you have written, seriously.

For messages written to accurately express what they want to say, in the message before you send it, then see if the content is complete, if there are typos, such as whether a statement is clear and coherent.

In the process of preparing a document, it closely follows the project team provided a template to complete. After you finished writing the document, grammar check on a document to correct typos and grammatical errors of the place. Generally speaking, the statement that there is a syntax error will have a green squiggly line under it. Before the document is submitted, and then read through the entire document to see if there are omissions and deficiencies.

In his spare time, you can read to improve language skills and ability to write books or articles, take a look at how others are articulating his thoughts. For example, often reading CSDN excellent blogger's blog is a good way to improve your writing skills.

In General, and do other things, like writing document also reflects an individual's attitudes. To produce high quality document, can not only improve their image (if you see a good document, is also the author has a higher rating? ), As well as to enhance the image of the product in the minds of customers. Such analysis and spend some effort to write the document really is necessary.

If you want to do one thing, we need efforts from every aspect. In the process of developing software, writing good code is important, clearly express themselves clearly in the document are also very important. "Code" and "documents" looks like a man who's right-hand man, be sure to keep the two balanced development, rather than just one or the other.




添加到del.icio.us 添加到新浪ViVi 添加到百度搜藏 添加到POCO网摘 添加到天天网摘365Key 添加到和讯网摘 添加到天极网摘 添加到黑米书签 添加到QQ书签 添加到雅虎收藏 添加到奇客发现 diigo it 添加到饭否 添加到飞豆订阅 添加到抓虾收藏 添加到鲜果订阅 digg it 貼到funP 添加到有道阅读 Live Favorites 添加到Newsvine 打印本页 用Email发送本页 在Facebook上分享


Disclaimer Privacy Policy About us Site Map

If you have any requirements, please contact webmaster。(如果有什么要求,请联系站长)
Copyright ©2011-
uuhomepage.com, Inc. All rights reserved.