Comments on: Docs, docs, docs, docs… http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/ Bits on the rampage: Eric Shepherd's blog. Thu, 20 Nov 2008 21:46:02 +0000 http://wordpress.org/?v=2.6.3 By: Alex Vincent http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-1187 Alex Vincent Wed, 01 Nov 2006 02:13:39 +0000 http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-1187 I'll be contacting you shortly. I’ll be contacting you shortly.

]]> By: Lynn Gold http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-1070 Lynn Gold Thu, 26 Oct 2006 17:46:45 +0000 http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-1070 Contact me @ figmo at rahul.net. Contact me @ figmo at rahul.net.

]]> By: sheppy http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-990 sheppy Sun, 22 Oct 2006 14:01:29 +0000 http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-990 I wouldn't have said we were looking to hire another technical writer if we weren't willing to pay them. :D I wouldn’t have said we were looking to hire another technical writer if we weren’t willing to pay them. :D

]]> By: Lynn Gold http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-977 Lynn Gold Sat, 21 Oct 2006 21:15:12 +0000 http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-977 Are you really looking for a tech writer, and are y'all willing to pay? Are you really looking for a tech writer, and are y’all willing to pay?

]]> By: Nickolay Ponomarev http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-959 Nickolay Ponomarev Fri, 20 Oct 2006 19:04:57 +0000 http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-959 "There should be detailed instructions for creating toolbar buttons" There already are: http://developer.mozilla.org/en/docs/Creating_toolbar_buttons http://developer.mozilla.org/en/docs/Custom_Toolbar_Button “There should be detailed instructions for creating toolbar buttons”

There already are:
http://developer.mozilla.org/en/docs/Creating_toolbar_buttons
http://developer.mozilla.org/en/docs/Custom_Toolbar_Button

]]> By: Jorge Villalobos http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-952 Jorge Villalobos Thu, 19 Oct 2006 23:16:42 +0000 http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-952 I maintain a little blog called xulsolutions (see link in my name) where I try to solve mundane and small problems in XUL development. It's not for the advanced developers, nor is it intended to be a full guide. Just a series of snippets and explanations. Maybe this is something like what you're talking about. I maintain a little blog called xulsolutions (see link in my name) where I try to solve mundane and small problems in XUL development. It’s not for the advanced developers, nor is it intended to be a full guide. Just a series of snippets and explanations. Maybe this is something like what you’re talking about.

]]> By: Jesse Ruderman http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-951 Jesse Ruderman Thu, 19 Oct 2006 23:03:55 +0000 http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-951 One question that comes up again and again is "how do I make my extension react to page loads?". There are subtle differences -- an extension like "How'd I Get Here" wants to know when the current URL changes, so it wants to be notified at the beginning of a page load and when you switch tabs, while an extension like "Search Keys" wants to react at the end of loads and be notified even for background tabs. There should be detailed instructions for creating toolbar buttons, if there aren't already. Extension developers need to know which sizes are needed, what CSS is needed to make them work, how to use -moz-image-region, design hints to make them fit in with other buttons (e.g. become slightly darker when hovered over). Also, there's the problem of installing an extension that adds a toolbar button, but not having it appear on the toolbar automatically (see bug 242071). Are extension developers supposed to put the button on the toolbar for you, and if so, how and where on the toolbar? Pop up the "Customize Toolbar" window upon first run with the extension? Pop up a dialog saying "Please add the 'How'd I get here' button to your toolbar"? One question that comes up again and again is “how do I make my extension react to page loads?”. There are subtle differences — an extension like “How’d I Get Here” wants to know when the current URL changes, so it wants to be notified at the beginning of a page load and when you switch tabs, while an extension like “Search Keys” wants to react at the end of loads and be notified even for background tabs.

There should be detailed instructions for creating toolbar buttons, if there aren’t already. Extension developers need to know which sizes are needed, what CSS is needed to make them work, how to use -moz-image-region, design hints to make them fit in with other buttons (e.g. become slightly darker when hovered over).

Also, there’s the problem of installing an extension that adds a toolbar button, but not having it appear on the toolbar automatically (see bug 242071). Are extension developers supposed to put the button on the toolbar for you, and if so, how and where on the toolbar? Pop up the “Customize Toolbar” window upon first run with the extension? Pop up a dialog saying “Please add the ‘How’d I get here’ button to your toolbar”?

]]> By: Shawn Wilsher http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-950 Shawn Wilsher Thu, 19 Oct 2006 21:04:51 +0000 http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-950 I really think pretty much everything is covered between mozillazine and devmo, so if you just got all the mozillazine docs on devmo, it would be helpful. I really think pretty much everything is covered between mozillazine and devmo, so if you just got all the mozillazine docs on devmo, it would be helpful.

]]> By: Nickolay Ponomarev http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-949 Nickolay Ponomarev Thu, 19 Oct 2006 20:15:06 +0000 http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-949 Most docs there are fine already, they just need to be copy-edited and migrated to MDC. The right thing to do is to monitor the newsgroups/forums/IRC. In case you haven't seen it, I started http://developer.mozilla.org/en/docs/User:Nickolay/FAQ . I'll try to add the FAQs I notice to that page. Most docs there are fine already, they just need to be copy-edited and migrated to MDC.

The right thing to do is to monitor the newsgroups/forums/IRC. In case you haven’t seen it, I started http://developer.mozilla.org/en/docs/User:Nickolay/FAQ . I’ll try to add the FAQs I notice to that page.

]]> By: Myk Melez http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-948 Myk Melez Thu, 19 Oct 2006 18:45:54 +0000 http://www.bitstampede.com/2006/10/19/docs-docs-docs-docs/#comment-948 One good place to start would be the extension development documentation project: http://kb.mozillazine.org/Extension_development Particularly the example code section: http://kb.mozillazine.org/Category:Example_code One good place to start would be the extension development documentation project:

http://kb.mozillazine.org/Extension_development

Particularly the example code section:

http://kb.mozillazine.org/Category:Example_code

]]>