Addon SDk documentation is not user friendly

RESOLVED INCOMPLETE

Status

P2
normal
RESOLVED INCOMPLETE
2 years ago
2 years ago

People

(Reporter: sankar88.aj, Unassigned)

Tracking

Details

(Reporter)

Description

2 years ago
:: Developer Documentation Request

      Request Type: New Documentation
     Gecko Version: 45 Branch
 Technical Contact: 

:: Details

Hello,

Here are my feedback to Addon documentation,
1. Documentation is not user friendly, not appealing. 
2. API and building procedure are hard to use and test. Lot of pre-req and dependencies.
3. No tutorial available, how do you expect developers to scratch their head ?
4. Make any application building as simple as possible.

Note: Take a look at chrome extension or any other documentation. I was able to build extension quickly. 
I'm a novice developer, i find chrome documentation was easy to use and follow.
Since, my customer are using firefox, i've to undergo pain in building a firefox addons.
please make it simple.
Thanks for the report! Unfortunately it's not really actionable as it is.

(In reply to sankar88.aj from comment #0)
> :: Developer Documentation Request
> 
>       Request Type: New Documentation
>      Gecko Version: 45 Branch
>  Technical Contact: 
> 
> :: Details
> 
> Hello,
> 
> Here are my feedback to Addon documentation,
> 1. Documentation is not user friendly, not appealing. 

This is not actionable. "user friendly" and "appealing" are not specific enough.

> 2. API and building procedure are hard to use and test. Lot of pre-req and
> dependencies.

This sounds like a criticism of the SDK itself, not the docs. What "pre-req and dependencies" exactly are you talking about? As far as I know, the steps in https://developer.mozilla.org/en-US/Add-ons/SDK/Tools/jpm#Installation should get you going.

> 3. No tutorial available, how do you expect developers to scratch their head

I'm not sure what exactly you mean by "tutorial". There's a "getting started" here: https://developer.mozilla.org/en-US/Add-ons/SDK/Tutorials/Getting_Started_(jpm), and lots more tutorials for specific things here: https://developer.mozilla.org/en-US/Add-ons/SDK/Tutorials.

> 4. Make any application building as simple as possible.

This isn't actionable, you need to be more specific.

> Note: Take a look at chrome extension or any other documentation. I was able
> to build extension quickly. 
> I'm a novice developer, i find chrome documentation was easy to use and
> follow.
> Since, my customer are using firefox, i've to undergo pain in building a
> firefox addons.
> please make it simple.
Status: UNCONFIRMED → RESOLVED
Last Resolved: 2 years ago
Resolution: --- → INCOMPLETE
You need to log in before you can comment on or make changes to this bug.