On 13 Dec 2013, at 14:51, Adrian Custer <[email protected]> wrote: > 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.
Well, speaking as someone who has done a number of builds and installed them successfully on devices, it looked like it made enough sense to link to. This is the nature of MDN anyway - things that are published, are published. This also tends to encourage quicker tech reviews ;-) Since I am the docs guy rather than a platform expert, I would still like to encourage one of our B2G enginners to give this doc a read over, asap. > > > 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… This is definitely a thing I need to work on. There is a lot here, and it could use some improved IA. I kind of got to the point where I couldn’t see the wood for the trees with this section of the site, so I left it for a while and went on to other things. Again, any ideas will be listened to ;-) > > > 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
