<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	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/"
		>
<channel>
	<title>Comments on: Dear Kohana, I Detest Your 3.x Website</title>
	<atom:link href="http://www.jqueryin.com/2010/07/19/kohana-3-documentation-and-features/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.jqueryin.com/2010/07/19/kohana-3-documentation-and-features/</link>
	<description>A web development blog focusing on PHP, MySQL, Javascript, jQuery, and CSS.</description>
	<lastBuildDate>Thu, 26 Jan 2012 14:32:59 +0000</lastBuildDate>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.0.1</generator>
	<item>
		<title>By: Web Developer Rob</title>
		<link>http://www.jqueryin.com/2010/07/19/kohana-3-documentation-and-features/comment-page-1/#comment-2154</link>
		<dc:creator>Web Developer Rob</dc:creator>
		<pubDate>Sat, 14 May 2011 17:20:52 +0000</pubDate>
		<guid isPermaLink="false">http://www.jqueryin.com/?p=603#comment-2154</guid>
		<description>I&#039;ve had a really good look at Kohana and nearly started to use it over CodeIgniter. The main thing swaying my decision was the lack of Kohana documentation - yes everyone may not need it, but personally, as someone picking up a new framework a comprehensive doc is a must really.</description>
		<content:encoded><![CDATA[<p>I&#8217;ve had a really good look at Kohana and nearly started to use it over CodeIgniter. The main thing swaying my decision was the lack of Kohana documentation &#8211; yes everyone may not need it, but personally, as someone picking up a new framework a comprehensive doc is a must really.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Corey Ballou</title>
		<link>http://www.jqueryin.com/2010/07/19/kohana-3-documentation-and-features/comment-page-1/#comment-2058</link>
		<dc:creator>Corey Ballou</dc:creator>
		<pubDate>Wed, 20 Apr 2011 00:47:48 +0000</pubDate>
		<guid isPermaLink="false">http://www.jqueryin.com/?p=603#comment-2058</guid>
		<description>True indeed, Jason. I believe user supplied code examples in the Disqus comments is a great start as well.</description>
		<content:encoded><![CDATA[<p>True indeed, Jason. I believe user supplied code examples in the Disqus comments is a great start as well.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Corey Ballou</title>
		<link>http://www.jqueryin.com/2010/07/19/kohana-3-documentation-and-features/comment-page-1/#comment-1942</link>
		<dc:creator>Corey Ballou</dc:creator>
		<pubDate>Fri, 25 Mar 2011 10:02:29 +0000</pubDate>
		<guid isPermaLink="false">http://www.jqueryin.com/?p=603#comment-1942</guid>
		<description>I&#039;m sorry my opinions offend you Ben. This is the internet; so take the ear-muffs off and prepare yourself for unfiltered biased opinions.</description>
		<content:encoded><![CDATA[<p>I&#8217;m sorry my opinions offend you Ben. This is the internet; so take the ear-muffs off and prepare yourself for unfiltered biased opinions.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Jason Nathan</title>
		<link>http://www.jqueryin.com/2010/07/19/kohana-3-documentation-and-features/comment-page-1/#comment-1855</link>
		<dc:creator>Jason Nathan</dc:creator>
		<pubDate>Tue, 22 Feb 2011 16:11:53 +0000</pubDate>
		<guid isPermaLink="false">http://www.jqueryin.com/?p=603#comment-1855</guid>
		<description>I suppose documentation is a real tough job. The unofficial WIKI does a great job of &quot;use case scenarios&quot;.

Just a little diversification of those use cases will be a great start... :)</description>
		<content:encoded><![CDATA[<p>I suppose documentation is a real tough job. The unofficial WIKI does a great job of &#8220;use case scenarios&#8221;.</p>
<p>Just a little diversification of those use cases will be a great start&#8230; :)</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Ben</title>
		<link>http://www.jqueryin.com/2010/07/19/kohana-3-documentation-and-features/comment-page-1/#comment-1546</link>
		<dc:creator>Ben</dc:creator>
		<pubDate>Sun, 09 Jan 2011 01:28:15 +0000</pubDate>
		<guid isPermaLink="false">http://www.jqueryin.com/?p=603#comment-1546</guid>
		<description>Alternatively, you&#039;re welcome to use another framework. 

I don&#039;t know if this is the way you intended it to sound, but your sense of entitlement astounds me.

These people have created something amazingly useful - and given it away free for you to use.</description>
		<content:encoded><![CDATA[<p>Alternatively, you&#8217;re welcome to use another framework. </p>
<p>I don&#8217;t know if this is the way you intended it to sound, but your sense of entitlement astounds me.</p>
<p>These people have created something amazingly useful &#8211; and given it away free for you to use.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Spyro</title>
		<link>http://www.jqueryin.com/2010/07/19/kohana-3-documentation-and-features/comment-page-1/#comment-1268</link>
		<dc:creator>Spyro</dc:creator>
		<pubDate>Thu, 23 Dec 2010 19:20:43 +0000</pubDate>
		<guid isPermaLink="false">http://www.jqueryin.com/?p=603#comment-1268</guid>
		<description>You say you liked more the 2.x docs. But they turn it OFF today. Anyone knows why?</description>
		<content:encoded><![CDATA[<p>You say you liked more the 2.x docs. But they turn it OFF today. Anyone knows why?</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Bob Bonfiield</title>
		<link>http://www.jqueryin.com/2010/07/19/kohana-3-documentation-and-features/comment-page-1/#comment-657</link>
		<dc:creator>Bob Bonfiield</dc:creator>
		<pubDate>Mon, 16 Aug 2010 17:28:46 +0000</pubDate>
		<guid isPermaLink="false">http://www.jqueryin.com/?p=603#comment-657</guid>
		<description>I couldn&#039;t agree more here cballou.  We&#039;ve been using Kohana for about a year now.  We started right around the time that the KO3 release was getting ready for a stable release, and we really wanted to jump on board with it then.  We knew that KO2.3.4 was going to be the legacy release from the get-go, but we simply couldn&#039;t justify using a framework with such horrible documentation -- API browsers are handy, but they&#039;re no substitute for well-written documentation.  And honestly, I&#039;m deeply saddened that, almost a year later, the docs site has barely improved.

A lot of developers hate to write documentation.  Fine, but Kohana isn&#039;t some project where the docs can be lacking.  If you want developers to jump on board or evangelize Kohana at their jobs, you need to have a usable and comprehensive docs site.  Comparing the docs for RoR or Django against Kohana is a joke.  Sure, they&#039;re larger projects, but how are we supposed to adopt a framework for our business when the learning curve for new developers is so high?

We&#039;re going to continue using KO2.3.4 until KO3 hits some sort of truly mature release.  IMHO, it seems like the development team needs to take this problem more serious.</description>
		<content:encoded><![CDATA[<p>I couldn&#8217;t agree more here cballou.  We&#8217;ve been using Kohana for about a year now.  We started right around the time that the KO3 release was getting ready for a stable release, and we really wanted to jump on board with it then.  We knew that KO2.3.4 was going to be the legacy release from the get-go, but we simply couldn&#8217;t justify using a framework with such horrible documentation &#8212; API browsers are handy, but they&#8217;re no substitute for well-written documentation.  And honestly, I&#8217;m deeply saddened that, almost a year later, the docs site has barely improved.</p>
<p>A lot of developers hate to write documentation.  Fine, but Kohana isn&#8217;t some project where the docs can be lacking.  If you want developers to jump on board or evangelize Kohana at their jobs, you need to have a usable and comprehensive docs site.  Comparing the docs for RoR or Django against Kohana is a joke.  Sure, they&#8217;re larger projects, but how are we supposed to adopt a framework for our business when the learning curve for new developers is so high?</p>
<p>We&#8217;re going to continue using KO2.3.4 until KO3 hits some sort of truly mature release.  IMHO, it seems like the development team needs to take this problem more serious.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: cballou</title>
		<link>http://www.jqueryin.com/2010/07/19/kohana-3-documentation-and-features/comment-page-1/#comment-602</link>
		<dc:creator>cballou</dc:creator>
		<pubDate>Tue, 20 Jul 2010 14:44:53 +0000</pubDate>
		<guid isPermaLink="false">http://www.jqueryin.com/?p=603#comment-602</guid>
		<description>I&#039;ll be in there as &lt;strong&gt;cballou&lt;/strong&gt; this evening after 7:30.</description>
		<content:encoded><![CDATA[<p>I&#8217;ll be in there as <strong>cballou</strong> this evening after 7:30.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Jeremy Bush</title>
		<link>http://www.jqueryin.com/2010/07/19/kohana-3-documentation-and-features/comment-page-1/#comment-600</link>
		<dc:creator>Jeremy Bush</dc:creator>
		<pubDate>Mon, 19 Jul 2010 15:32:48 +0000</pubDate>
		<guid isPermaLink="false">http://www.jqueryin.com/?p=603#comment-600</guid>
		<description>Oh, if you want to help with docs, you are welcome to ;)

Hop into #kohana on irc.freenode.net if you want to talk about it.</description>
		<content:encoded><![CDATA[<p>Oh, if you want to help with docs, you are welcome to ;)</p>
<p>Hop into #kohana on irc.freenode.net if you want to talk about it.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: cballou</title>
		<link>http://www.jqueryin.com/2010/07/19/kohana-3-documentation-and-features/comment-page-1/#comment-599</link>
		<dc:creator>cballou</dc:creator>
		<pubDate>Mon, 19 Jul 2010 15:14:45 +0000</pubDate>
		<guid isPermaLink="false">http://www.jqueryin.com/?p=603#comment-599</guid>
		<description>Jeremy, 

Thanks for the insight regarding the post.  I really do applaud the effort you guys put in and I know the debugging process is quite painstaking in it&#039;s own right. 

I don&#039;t believe there are necessarily problems with the Redmine reports themselves, but problems with sifting through them to find some information that should be fairly trivial.  The reports are, in essence, a little &lt;em&gt;too&lt;/em&gt; detailed and cover a number of issues and fixes which aren&#039;t necessarily pertinent to what the majority of your users care about.  Most users don&#039;t necessarily need to know that you fixed bugs X, Y, and Z on your main page if they don&#039;t inherently change a method&#039;s initial intent or functionality.  What they do need to know, however, is if you change a function&#039;s parameters, return values, output, etc.  Or perhaps if you deprecate a function or entire class in favor of a new method or class.  

Redmine is perfect for the nitty gritty details when a developer catches wind of an apparent bug in the system.  It does not seem to function as a good solution for supplying a summary of updates to classes and methods which affect the developer&#039;s ability making system calls. 

I hope this makes sense, as does my article.  It&#039;s purpose was to summarize what I believe to be some of the aspects that hinder Kohana&#039;s growth as a framework.  I can say I am in favor of a number of changes made in v3.x.  While I&#039;m at it, I might as well throw a request that you guys consider including the modules SwiftMailer and Message into your packaging system as they are two features I miss drastically from 2.x and took a little searching to find 3.x alternatives.</description>
		<content:encoded><![CDATA[<p>Jeremy, </p>
<p>Thanks for the insight regarding the post.  I really do applaud the effort you guys put in and I know the debugging process is quite painstaking in it&#8217;s own right. </p>
<p>I don&#8217;t believe there are necessarily problems with the Redmine reports themselves, but problems with sifting through them to find some information that should be fairly trivial.  The reports are, in essence, a little <em>too</em> detailed and cover a number of issues and fixes which aren&#8217;t necessarily pertinent to what the majority of your users care about.  Most users don&#8217;t necessarily need to know that you fixed bugs X, Y, and Z on your main page if they don&#8217;t inherently change a method&#8217;s initial intent or functionality.  What they do need to know, however, is if you change a function&#8217;s parameters, return values, output, etc.  Or perhaps if you deprecate a function or entire class in favor of a new method or class.  </p>
<p>Redmine is perfect for the nitty gritty details when a developer catches wind of an apparent bug in the system.  It does not seem to function as a good solution for supplying a summary of updates to classes and methods which affect the developer&#8217;s ability making system calls. </p>
<p>I hope this makes sense, as does my article.  It&#8217;s purpose was to summarize what I believe to be some of the aspects that hinder Kohana&#8217;s growth as a framework.  I can say I am in favor of a number of changes made in v3.x.  While I&#8217;m at it, I might as well throw a request that you guys consider including the modules SwiftMailer and Message into your packaging system as they are two features I miss drastically from 2.x and took a little searching to find 3.x alternatives.</p>
]]></content:encoded>
	</item>
</channel>
</rss>

