<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>Блог Андрея Смирнова &#187; документирование</title>
	<atom:link href="http://www.smira.ru/tag/%d0%b4%d0%be%d0%ba%d1%83%d0%bc%d0%b5%d0%bd%d1%82%d0%b8%d1%80%d0%be%d0%b2%d0%b0%d0%bd%d0%b8%d0%b5/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.smira.ru</link>
	<description></description>
	<lastBuildDate>Wed, 24 Aug 2011 05:09:27 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.2.1</generator>
		<item>
		<title>Как передать ощущение чуда другим?</title>
		<link>http://www.smira.ru/2008/02/04/unit-test-miracle/</link>
		<comments>http://www.smira.ru/2008/02/04/unit-test-miracle/#comments</comments>
		<pubDate>Mon, 04 Feb 2008 20:38:52 +0000</pubDate>
		<dc:creator>Андрей</dc:creator>
				<category><![CDATA[Разработка]]></category>
		<category><![CDATA[документирование]]></category>
		<category><![CDATA[код]]></category>
		<category><![CDATA[разработка]]></category>
		<category><![CDATA[юнит-тест]]></category>

		<guid isPermaLink="false">http://www.smira.ru/2008/02/04/unit-test-miracle/</guid>
		<description><![CDATA[Вот я знаю, что юнит-тесты и документирование кода &#8211; это чудо. Правда, это чудесные идеи, которые потрясающе повышают эффективность работы. Но это знаю я, я этим активно пользуюсь, не могу без этого уже работать. Как объяснить это другим? Как их &#171;зажечь&#187; этой возможностью? Ведь и то, и другое лень. На это нужно время&#8230; Объяснить на [...]]]></description>
			<content:encoded><![CDATA[<p>Вот я знаю, что юнит-тесты и документирование кода &#8211; это чудо. Правда, это чудесные идеи, которые потрясающе повышают эффективность работы. Но это знаю я, я этим активно пользуюсь, не могу без этого уже работать.</p>

<p>Как объяснить это другим? Как их &laquo;зажечь&raquo; этой возможностью?</p>

<p>Ведь и то, и другое <em>лень</em>. На это нужно <em>время</em>&#8230; Объяснить на пальцах, что и то, и другое, <em>экономит</em> время, очень тяжело. Программисту кажется, что кроме выполнения его основных обязанностей &#8211; написания кода &#8211; его заставляют делать что-то ещё, что непосредственно не является <em>видимым</em> результатом его деятельности. Да, конечные пользователи продукта не увидят юнит-тестов и их совершенно не будет интересовать документация по коду. Но ведь эти средства позволяют (при грамотном использовании, конечно) улучшить <em>качество</em> продукта, а это конечные пользователи заметят, и именно это должно служить основной мотивацией для разработчика.</p>

<p>Мне кажется, что документация &#8211; это сродни чистоплотности, это то же самое, что и форматирование (оформление) кода, это ещё один аспект <em>читаемости</em> кода. Если я уважаю человека, который будет читать мой код, я должен его красиво оформить, снабдить комментариями. Ведь мы моемся, одеваем чистую одежду, чтобы другим людям не было противно с нами общаться. И здесь наш код &#8211; одежка, по которой нас встречают.</p>

<p>Так как всё-таки передать другим ощущение чуда? Мне кажется, очень важно показать пример, показать результат деятельности. Вот, смотри, давай построим документацию по коду &#8211; красота&#8230; Вот, этот модуль полностью отдокументирован и он выглядит так классно. А вот твой файл&#8230; Добавишь комментарии &#8211; и ведь он будет такой же! Юнит-тесты так же. Показать пример, как увеличивается скорость разработки от применения юнит-тестов!</p>
]]></content:encoded>
			<wfw:commentRss>http://www.smira.ru/2008/02/04/unit-test-miracle/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
	</channel>
</rss>

