<?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: I refuse to rehash the docs	</title>
	<atom:link href="https://jessewarden.com/2003/05/i-refuse-to-rehash-the-docs.html/feed" rel="self" type="application/rss+xml" />
	<link>https://jessewarden.com/2003/05/i-refuse-to-rehash-the-docs.html</link>
	<description>Software &#124; Fitness &#124; Gaming</description>
	<lastBuildDate>Mon, 19 May 2003 17:12:08 +0000</lastBuildDate>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	
	<item>
		<title>
		By: JesterXL		</title>
		<link>https://jessewarden.com/2003/05/i-refuse-to-rehash-the-docs.html/comment-page-1#comment-376</link>

		<dc:creator><![CDATA[JesterXL]]></dc:creator>
		<pubDate>Mon, 19 May 2003 17:12:08 +0000</pubDate>
		<guid isPermaLink="false">http://jessewarden.com/?p=137#comment-376</guid>

					<description><![CDATA[My goal, again, is to help the reader succeed by reading what they need to know.  If I add already existing content from the docs, it&#039;s because I am adding my own comments to it, in my own words.  I&#039;m trying my best to do good!
]]></description>
			<content:encoded><![CDATA[<p>My goal, again, is to help the reader succeed by reading what they need to know.  If I add already existing content from the docs, it&#8217;s because I am adding my own comments to it, in my own words.  I&#8217;m trying my best to do good!</p>
]]></content:encoded>
		
			</item>
		<item>
		<title>
		By: Guest		</title>
		<link>https://jessewarden.com/2003/05/i-refuse-to-rehash-the-docs.html/comment-page-1#comment-375</link>

		<dc:creator><![CDATA[Guest]]></dc:creator>
		<pubDate>Mon, 19 May 2003 09:14:47 +0000</pubDate>
		<guid isPermaLink="false">http://jessewarden.com/?p=137#comment-375</guid>

					<description><![CDATA[Whatever you do don&#039;t write a book like Robert&#039;s FCS book... I&#039;ve never seen a book copy so much out of the already built components and copy so much out of the docs...  please!!!]]></description>
			<content:encoded><![CDATA[<p>Whatever you do don&#8217;t write a book like Robert&#8217;s FCS book&#8230; I&#8217;ve never seen a book copy so much out of the already built components and copy so much out of the docs&#8230;  please!!!</p>
]]></content:encoded>
		
			</item>
		<item>
		<title>
		By: Greg Burch		</title>
		<link>https://jessewarden.com/2003/05/i-refuse-to-rehash-the-docs.html/comment-page-1#comment-374</link>

		<dc:creator><![CDATA[Greg Burch]]></dc:creator>
		<pubDate>Sun, 18 May 2003 18:41:55 +0000</pubDate>
		<guid isPermaLink="false">http://jessewarden.com/?p=137#comment-374</guid>

					<description><![CDATA[When I write I find myself on the same boat as you. I always end up explaining too much and don&#039;t know where to stop :) After a few times I got better but I still don&#039;t know when to shutup. It makes it really hard to write too because to explain something simple you end up writing for page after page. I can&#039;t offer you any advice because my choice was to simply not write anymore. But I did want to let you know you are not alone :).

PS I may write in the future but its highly doubtful. I don&#039;t have the time to write a book of my own, and like said above multi-author books are just too disconnected...and of course finally...books just don&#039;t pay off (for me)]]></description>
			<content:encoded><![CDATA[<p>When I write I find myself on the same boat as you. I always end up explaining too much and don&#8217;t know where to stop :) After a few times I got better but I still don&#8217;t know when to shutup. It makes it really hard to write too because to explain something simple you end up writing for page after page. I can&#8217;t offer you any advice because my choice was to simply not write anymore. But I did want to let you know you are not alone :).</p>
<p>PS I may write in the future but its highly doubtful. I don&#8217;t have the time to write a book of my own, and like said above multi-author books are just too disconnected&#8230;and of course finally&#8230;books just don&#8217;t pay off (for me)</p>
]]></content:encoded>
		
			</item>
		<item>
		<title>
		By: JesterXL		</title>
		<link>https://jessewarden.com/2003/05/i-refuse-to-rehash-the-docs.html/comment-page-1#comment-373</link>

		<dc:creator><![CDATA[JesterXL]]></dc:creator>
		<pubDate>Sun, 18 May 2003 06:48:46 +0000</pubDate>
		<guid isPermaLink="false">http://jessewarden.com/?p=137#comment-373</guid>

					<description><![CDATA[ActionScript in a Nutshell v1.  It had an entire back devoted to a &quot;correct&quot; version of the documentation.  Nobody who used Flash utized the help, but instead referred to, &quot;...on page 384 of ASDG, it cleary states that XML.onLoad blah blah blah...&quot;.  It was rehashed documentation, but Moock corrected things, and added his own examples.

From the other side of the fence, there have been a ton of books, wish I could give you titles, who talk about how to make a button in Flash.  Honest to God, how many ways can you spin the wording to say how to make a button without really saying how to make a button?  They all tell you, but so does the Flash manual.

...but therein lies the issue, I guess.   All of this spawns from my personal style of book.  Nowadays, I don&#039;t like how too books.  If I buy a book, I usually only read a chapter, and instead refer to specific pages of the book to figure out how to do something.  This wasn&#039;t always the case, but I&#039;ve gotten good, in my opinion, on teaching myself and consolidating through a lot of un-needed information.  Case in point, PHP for the WWW books.  I refer to specific page numbers, and one specific chapter to do things.  I learned how to code in PHP in one night after my gf couldn&#039;t get a Perl script working.  It was Flash with $ in front of variable names.  When I hit a snag, I borrowed my gf&#039;s books which she bought the next day.  I stole it immediately, but only read 20% of each chapter, and then only about 4 chapters of the 12 chapter book consisting of about 500 pages.  Just give me how to call a record set from mySQL, I&#039;ll figure out the rest thanks.

This is not the most effective way of learning, I&#039;m sure.  But, recently discovering that I had some developer in me, I like re-inventing the wheel or struggling through some parts to help myself better understand the whys of how things work.

Maybe that personality trait is coming out in my writing, but I feel I only want to write about things that are pertainent to a fellow developer, or even someone who is a designer and has a different mindset.  To me, if I can focus on that, I&#039;ve succeeded in telling the reader what they needed to succeed.  I&#039;ve never liked docs, but couldn&#039;t live without them.  I feel I&#039;m just helping MM out with my spin and experiences put on their docs to better help people be successful.  This one chapter, though, is making that 2nd part helpful.  Maybe I just don&#039;t hang out with enough admins to know what they&#039;re like.

Anyway, I&#039;m screwed on the concise front.  Both of my college professors said I had problems with shutting up.  One said if you ask me what time it is, I&#039;ll tell you how a watch works.  The other said I should answer the person&#039;s question, period.  If the person wants more information, they&#039;ll ask.

...I disagreed with both, of course.  Bleh.  I at least feel better about you saying that I can point to the docs.  That makes me feel... a whole lot better.  Still, not sure about the linearty or theme.  The only book I saw successfully done (and I haven&#039;t read many tech books, mind you, from front to back) is this D&#038;D book about the Fiends of the Outer planes.  Each chapter was done by not only a different author, but a different &quot;type&quot; of author.  One was an evil demon, another a gigantic frog from a land of chaos... some with villanous grammar, others with character perks berating their perceived intelligence only until you noticed you&#039;ve read 5 pages of their spiel about things they know.  Really well done, but then, that&#039;s TS...er, Wizards of the Coast&#039;s full time job.  This to me is just doing my part to help out the Flash Community.

Cool, at least I feel like I&#039;m on the right path again.  Thanks, yo.]]></description>
			<content:encoded><![CDATA[<p>ActionScript in a Nutshell v1.  It had an entire back devoted to a &#8220;correct&#8221; version of the documentation.  Nobody who used Flash utized the help, but instead referred to, &#8220;&#8230;on page 384 of ASDG, it cleary states that XML.onLoad blah blah blah&#8230;&#8221;.  It was rehashed documentation, but Moock corrected things, and added his own examples.</p>
<p>From the other side of the fence, there have been a ton of books, wish I could give you titles, who talk about how to make a button in Flash.  Honest to God, how many ways can you spin the wording to say how to make a button without really saying how to make a button?  They all tell you, but so does the Flash manual.</p>
<p>&#8230;but therein lies the issue, I guess.   All of this spawns from my personal style of book.  Nowadays, I don&#8217;t like how too books.  If I buy a book, I usually only read a chapter, and instead refer to specific pages of the book to figure out how to do something.  This wasn&#8217;t always the case, but I&#8217;ve gotten good, in my opinion, on teaching myself and consolidating through a lot of un-needed information.  Case in point, PHP for the WWW books.  I refer to specific page numbers, and one specific chapter to do things.  I learned how to code in PHP in one night after my gf couldn&#8217;t get a Perl script working.  It was Flash with $ in front of variable names.  When I hit a snag, I borrowed my gf&#8217;s books which she bought the next day.  I stole it immediately, but only read 20% of each chapter, and then only about 4 chapters of the 12 chapter book consisting of about 500 pages.  Just give me how to call a record set from mySQL, I&#8217;ll figure out the rest thanks.</p>
<p>This is not the most effective way of learning, I&#8217;m sure.  But, recently discovering that I had some developer in me, I like re-inventing the wheel or struggling through some parts to help myself better understand the whys of how things work.</p>
<p>Maybe that personality trait is coming out in my writing, but I feel I only want to write about things that are pertainent to a fellow developer, or even someone who is a designer and has a different mindset.  To me, if I can focus on that, I&#8217;ve succeeded in telling the reader what they needed to succeed.  I&#8217;ve never liked docs, but couldn&#8217;t live without them.  I feel I&#8217;m just helping MM out with my spin and experiences put on their docs to better help people be successful.  This one chapter, though, is making that 2nd part helpful.  Maybe I just don&#8217;t hang out with enough admins to know what they&#8217;re like.</p>
<p>Anyway, I&#8217;m screwed on the concise front.  Both of my college professors said I had problems with shutting up.  One said if you ask me what time it is, I&#8217;ll tell you how a watch works.  The other said I should answer the person&#8217;s question, period.  If the person wants more information, they&#8217;ll ask.</p>
<p>&#8230;I disagreed with both, of course.  Bleh.  I at least feel better about you saying that I can point to the docs.  That makes me feel&#8230; a whole lot better.  Still, not sure about the linearty or theme.  The only book I saw successfully done (and I haven&#8217;t read many tech books, mind you, from front to back) is this D&amp;D book about the Fiends of the Outer planes.  Each chapter was done by not only a different author, but a different &#8220;type&#8221; of author.  One was an evil demon, another a gigantic frog from a land of chaos&#8230; some with villanous grammar, others with character perks berating their perceived intelligence only until you noticed you&#8217;ve read 5 pages of their spiel about things they know.  Really well done, but then, that&#8217;s TS&#8230;er, Wizards of the Coast&#8217;s full time job.  This to me is just doing my part to help out the Flash Community.</p>
<p>Cool, at least I feel like I&#8217;m on the right path again.  Thanks, yo.</p>
]]></content:encoded>
		
			</item>
		<item>
		<title>
		By: Phillip Kerman		</title>
		<link>https://jessewarden.com/2003/05/i-refuse-to-rehash-the-docs.html/comment-page-1#comment-372</link>

		<dc:creator><![CDATA[Phillip Kerman]]></dc:creator>
		<pubDate>Sun, 18 May 2003 02:08:38 +0000</pubDate>
		<guid isPermaLink="false">http://jessewarden.com/?p=137#comment-372</guid>

					<description><![CDATA[I&#039;m curious what books are doing that.  Perhaps they&#039;re doing it by accident--I&#039;m just trying to give the benefit of the doubt.

Anyway, there&#039;s nothing wrong in referencing or pointing readers to the docs.  No sense in reinventing the wheel.  Even if  your book did have the same examples from the docs, one would hope you&#039;re providing more practical application.  If nothing else, people expect cohesion in a book... almost a linear story.  Well, reference books might be an exception.

Personally, I have a hard time actually READING technical books (my own being the hardest on my patience).  However, the thing that I see the most distracting in books is when a multi-author book is obviously not coordinated.  There are some good ones, but a few have no theme.  I believe a book should be able to be summed up in one or two sentences.  

The hardest thing for me--by the way--isn&#039;t avoiding plagiarism, but rather remaining concise.  I just want to get a point across and I&#039;ll sometimes take a few extra pages.  I feel like saying &quot;if you understand what I&#039;m saying jump ahead here&quot;.

Concise writing is the hardest in my opinion.

Thanks,
Phillip

P.S. Who says you can&#039;t say what book you&#039;re doing?]]></description>
			<content:encoded><![CDATA[<p>I&#8217;m curious what books are doing that.  Perhaps they&#8217;re doing it by accident&#8211;I&#8217;m just trying to give the benefit of the doubt.</p>
<p>Anyway, there&#8217;s nothing wrong in referencing or pointing readers to the docs.  No sense in reinventing the wheel.  Even if  your book did have the same examples from the docs, one would hope you&#8217;re providing more practical application.  If nothing else, people expect cohesion in a book&#8230; almost a linear story.  Well, reference books might be an exception.</p>
<p>Personally, I have a hard time actually READING technical books (my own being the hardest on my patience).  However, the thing that I see the most distracting in books is when a multi-author book is obviously not coordinated.  There are some good ones, but a few have no theme.  I believe a book should be able to be summed up in one or two sentences.  </p>
<p>The hardest thing for me&#8211;by the way&#8211;isn&#8217;t avoiding plagiarism, but rather remaining concise.  I just want to get a point across and I&#8217;ll sometimes take a few extra pages.  I feel like saying &#8220;if you understand what I&#8217;m saying jump ahead here&#8221;.</p>
<p>Concise writing is the hardest in my opinion.</p>
<p>Thanks,<br />
Phillip</p>
<p>P.S. Who says you can&#8217;t say what book you&#8217;re doing?</p>
]]></content:encoded>
		
			</item>
	</channel>
</rss>
