<?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"
	>
<channel>
	<title>Comments on: Updating add-ons for Firefox 3: Where do our docs blow?</title>
	<atom:link href="http://www.bitstampede.com/2008/01/03/updating-add-ons-for-firefox-3-where-do-our-docs-blow/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.bitstampede.com/2008/01/03/updating-add-ons-for-firefox-3-where-do-our-docs-blow/</link>
	<description>Bits on the rampage: Eric Shepherd's blog.</description>
	<pubDate>Thu, 20 Nov 2008 13:18:50 +0000</pubDate>
	<generator>http://wordpress.org/?v=2.6.3</generator>
		<item>
		<title>By: Eric</title>
		<link>http://www.bitstampede.com/2008/01/03/updating-add-ons-for-firefox-3-where-do-our-docs-blow/#comment-56991</link>
		<dc:creator>Eric</dc:creator>
		<pubDate>Fri, 04 Jan 2008 18:29:26 +0000</pubDate>
		<guid isPermaLink="false">http://www.bitstampede.com/2008/01/03/updating-add-ons-for-firefox-3-where-do-our-docs-blow/#comment-56991</guid>
		<description>Whoops, that was supposed to read "an unsupported mode". I'd be happy to help with all this, /msg me (fR) on IRC.</description>
		<content:encoded><![CDATA[<p>Whoops, that was supposed to read &#8220;an unsupported mode&#8221;. I&#8217;d be happy to help with all this, /msg me (fR) on IRC.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Eric</title>
		<link>http://www.bitstampede.com/2008/01/03/updating-add-ons-for-firefox-3-where-do-our-docs-blow/#comment-56990</link>
		<dc:creator>Eric</dc:creator>
		<pubDate>Fri, 04 Jan 2008 18:27:08 +0000</pubDate>
		<guid isPermaLink="false">http://www.bitstampede.com/2008/01/03/updating-add-ons-for-firefox-3-where-do-our-docs-blow/#comment-56990</guid>
		<description>Please improve documentation for dynamic bookmark containers.

nsIRemoteContainer no longer exists (bug 382877), this page should probably be deleted.
http://developer.mozilla.org/en/docs/nsIRemoteContainer

This page refers to nsIRemoteContainer, and also talks about an supported "mode" near the bottom, if this will not be supported by Firefox 3 final, can this be clarified?
http://developer.mozilla.org/en/docs/Places:Custom_Containers

This section should likely point to the new documentation:
http://developer.mozilla.org/en/docs/nsINavBookmarksService#createDynamicContainer.28.29

Thanks!</description>
		<content:encoded><![CDATA[<p>Please improve documentation for dynamic bookmark containers.</p>
<p>nsIRemoteContainer no longer exists (bug 382877), this page should probably be deleted.<br />
<a href="http://developer.mozilla.org/en/docs/nsIRemoteContainer" rel="nofollow">http://developer.mozilla.org/en/docs/nsIRemoteContainer</a></p>
<p>This page refers to nsIRemoteContainer, and also talks about an supported &#8220;mode&#8221; near the bottom, if this will not be supported by Firefox 3 final, can this be clarified?<br />
<a href="http://developer.mozilla.org/en/docs/Places:Custom_Containers" rel="nofollow">http://developer.mozilla.org/en/docs/Places:Custom_Containers</a></p>
<p>This section should likely point to the new documentation:<br />
<a href="http://developer.mozilla.org/en/docs/nsINavBookmarksService#createDynamicContainer.28.29" rel="nofollow">http://developer.mozilla.org/en/docs/nsINavBookmarksService#createDynamicContainer.28.29</a></p>
<p>Thanks!</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Marc Diethelm</title>
		<link>http://www.bitstampede.com/2008/01/03/updating-add-ons-for-firefox-3-where-do-our-docs-blow/#comment-56972</link>
		<dc:creator>Marc Diethelm</dc:creator>
		<pubDate>Fri, 04 Jan 2008 17:04:19 +0000</pubDate>
		<guid isPermaLink="false">http://www.bitstampede.com/2008/01/03/updating-add-ons-for-firefox-3-where-do-our-docs-blow/#comment-56972</guid>
		<description>In my experience the documentation for fx3 is fine. There's a standardized feel, examples (that work!). No problems here.

What's much more difficult is setting up a new extension, learning the basics. When I started coding in Mozilla a few months ago I had great difficulties: The examples were outdated (often simply didn't work in fx2), didn't apply if you weren't using them in the default way. Say, if you wanted to create a sidebar, like I did. So in order to make things work, or even appear in fx I started looking at other extensions, sometimes only learning much later what was actually going on or that half the code wasn't even needed.

If you're new to hacking Mozilla try to create and manipulate a Custom Tree View, it'll make you pull you hair out.

XPCOM still is a magic box to me: you use but you don't really know what's going on.
Stuff like: &lt;code&gt;var prefs = Components.classes["@mozilla.org/preferences-service;1"]
.getService(Components.interfaces.nsIPrefService).getBranch("extensions."+extension_name+".");&lt;/code&gt;
is really scary if you've never used it before. (The above example, btw, is the successful end result of quite some trials and errors, there was no complete example like this...)

Actually this wasn't my first try. All earlier attempts at creating a sidebar extension were just too frustrating to continue. That was before there was a Wiki on DevMo.

I realize this is slightly off-topic. But hopefully some good comes from it.

&lt;b&gt;All you developers who have had trouble achieving what you wanted try to integrate the information you were hoping to find on DevMo. Give something back to Mozilla!&lt;/b&gt; I spent quite some time updating the Storage (mozStorage) pages there. Anyway, thanks Sheppy for the great work!</description>
		<content:encoded><![CDATA[<p>In my experience the documentation for fx3 is fine. There&#8217;s a standardized feel, examples (that work!). No problems here.</p>
<p>What&#8217;s much more difficult is setting up a new extension, learning the basics. When I started coding in Mozilla a few months ago I had great difficulties: The examples were outdated (often simply didn&#8217;t work in fx2), didn&#8217;t apply if you weren&#8217;t using them in the default way. Say, if you wanted to create a sidebar, like I did. So in order to make things work, or even appear in fx I started looking at other extensions, sometimes only learning much later what was actually going on or that half the code wasn&#8217;t even needed.</p>
<p>If you&#8217;re new to hacking Mozilla try to create and manipulate a Custom Tree View, it&#8217;ll make you pull you hair out.</p>
<p>XPCOM still is a magic box to me: you use but you don&#8217;t really know what&#8217;s going on.<br />
Stuff like: <code>var prefs = Components.classes["@mozilla.org/preferences-service;1"]<br />
.getService(Components.interfaces.nsIPrefService).getBranch(&#8221;extensions.&#8221;+extension_name+&#8221;.&#8221;);</code><br />
is really scary if you&#8217;ve never used it before. (The above example, btw, is the successful end result of quite some trials and errors, there was no complete example like this&#8230;)</p>
<p>Actually this wasn&#8217;t my first try. All earlier attempts at creating a sidebar extension were just too frustrating to continue. That was before there was a Wiki on DevMo.</p>
<p>I realize this is slightly off-topic. But hopefully some good comes from it.</p>
<p><b>All you developers who have had trouble achieving what you wanted try to integrate the information you were hoping to find on DevMo. Give something back to Mozilla!</b> I spent quite some time updating the Storage (mozStorage) pages there. Anyway, thanks Sheppy for the great work!</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Mook</title>
		<link>http://www.bitstampede.com/2008/01/03/updating-add-ons-for-firefox-3-where-do-our-docs-blow/#comment-56819</link>
		<dc:creator>Mook</dc:creator>
		<pubDate>Fri, 04 Jan 2008 05:15:02 +0000</pubDate>
		<guid isPermaLink="false">http://www.bitstampede.com/2008/01/03/updating-add-ons-for-firefox-3-where-do-our-docs-blow/#comment-56819</guid>
		<description>I believe that parts of the Places documentation might be documenting what the interface claims, not what was actually implemented.  Not certain on this though, since I was actually trying to use it a while ago before giving up (Places didn't do what I wanted it to).  Also mentioned this to mfinkle in #extdev.</description>
		<content:encoded><![CDATA[<p>I believe that parts of the Places documentation might be documenting what the interface claims, not what was actually implemented.  Not certain on this though, since I was actually trying to use it a while ago before giving up (Places didn&#8217;t do what I wanted it to).  Also mentioned this to mfinkle in #extdev.</p>
]]></content:encoded>
	</item>
</channel>
</rss>
