On 12/13/13, 11:31 AM, Chris Mills wrote:
Hi Adrian,
Thanks a lot for the detailed feedback! I think it is exactly this
kind of constructive criticism that helps the most.
Cheers.
I am on the MDN team, and in charge of maintaining the Firefox OS doc
zone. You can feel free to aim any doc-specific stuff at me.
Okay. Nice to meet you.
> I’d like to request that some of the platform developers try to find
> some time to help me work out where our documentation is out of date
> and in need of fixing. I ran through all the build process docs about
> 2-3 months ago in detail, checked that it all works, and made a
> number of updates, but it may well be time to do that again ;-)
Your new article is very useful[1]; I have linked to it from the
main Firefox OS zone menu[2] and from the Building and installing
> sublanding page[3].
Oooh, no! It's not ready for that. Really, it needs a technical review
first! You can't have someone (me) writing how the build works who has
not successfully done a build and placed in on their device. Please revert.
Also, once it is deemed reliable, it will need to get integrated into
the various menus and sections:
https://developer.mozilla.org/en-US/Firefox_OS Left Nav Menu [DONE]
https://developer.mozilla.org/en-US/Firefox_OS "Build & ..." Section
https://developer.mozilla.org/en-US/Firefox_OS/Build_and_install Menu
https://developer.mozilla.org/en-US/Firefox_OS/Building_and_installing_Firefox_OS
"Getting and ..." Section
You are lost in a maze of twisty pages, all alike...
> I also gave it an editorial review, fixing a bunch of minor
> grammar/spelling/structural issues.
Thanks. Now I know how to make note blocks too.
All the best,
Chris Mills Senior tech writer || Mozilla developer.mozilla.org ||
MDN [email protected] || @chrisdavidmills
[1]
https://developer.mozilla.org/en-US/Firefox_OS/Building_and_installing_Firefox_OS/Firefox_OS_build_overview
[2] https://developer.mozilla.org/en-US/Firefox_OS
[3]
https://developer.mozilla.org/en-US/Firefox_OS/Building_and_installing_Firefox_OS
_______________________________________________
dev-b2g mailing list
[email protected]
https://lists.mozilla.org/listinfo/dev-b2g
