On 11/3/2013 8:48 PM, Sankha Narayan Guria wrote:
> One thing that I have noticed after talking to many new contributors is
> that, people are often overwhelmed by the large amount of the docs. They
> look for quick results when they are starting off.
>
> The idea of videos is great, but it would also help if we could have
> something like a quick start page, that could outline the only basic steps
> like:
>
> 1. The bootstrap command:
>     wget [.... bootstrap.py]
>
> 2. Clone mozilla-central:
>     hg clone http://hg.mozilla.org/mozilla-central/
>
> 3. Build the source:
>     ./mach build
>
> Once someone completes going through that, he will (most probably) have a
> working build running. We can then point them to a second part of the quick
> start that just says about creating a patch, like:
>
> 1. Create a new patch:
>     hg qnew [patchName]
>
> 2. Make your changes to the source and build with mach.
>
> 3. Update your patch file with:
>     hg qref
>
> 4. Upload to Bugzilla for review.
>
> While this isn't the complete docs per se, but reducing the size will get
> more people to read and try out these steps. We can always have a link to
> the accompanying video guide and the MDN page with each step.
>
This has been the point of the "Simple Firefox Build" page:
https://developer.mozilla.org/en-US/docs/Simple_Firefox_build

I don't know if it's discoverable for all people, or if it meets the
qualifications you've set out.

-Ted

_______________________________________________
dev-platform mailing list
dev-platform@lists.mozilla.org
https://lists.mozilla.org/listinfo/dev-platform

Reply via email to