MDN/Archives/Development/Redesign/Testing: Difference between revisions

Latest revision as of 20:48, 19 June 2017

The MDN redesign launched on December 9, 2013. While the beta testing phase is over, we are welcoming feedback on the live redesign site.

MDN is undergoing a major redesign with improved visual style, layout, page customization options, navigation, and platform features. To ensure that the redesign is the best it can be, we have made it available to anyone who would like to help with beta testing. Remember that this is a beta, so while we are correcting issues quickly, you may discover some bumps along the way.

How to become an MDN beta tester

Login into MDN.
Edit your profile.
Check the beta user checkbox.

Change overview

The most obvious differences include the new visual style and the new layout. Updates have also been made to the homepage, to site navigation, and to major features like site search. Additionally, some topics like Firefox OS and Web Apps are now represented as Zones, documentation sections with improved landing pages and a new secondary navigation sidebar.

Testing

We would love for you to go around the site and take a look at everything. Try reading documentation, editing pages and making other site contributions. Remember that even though you will see our new design, you will be working with the same documentation everyone else sees. Any changes you make will be seen by all users, whether they are testing the beta or not. So as part of your testing, please don't randomly change or delete content!

Suggestions

Looking for some ideas of things to do? Try testing out the following:

Documentation: Read our documentation just as you normally would. Pay attention to code samples, images, and videos. Some documentation, especially lesser-known documentation, has not yet been updated to fit with this new design. Let us know if you come across anything that doesn't look right.
Homepage: Is the content of the homepage valuable to you? How about the positioning, size and style of this content?
Navigation: Try getting around using only major site navigation. Can you find the information you need?
Search: Try out the improved search system. Consider both the experience of searching and the quality of search results.
Performance: How is performance? Is it better or worse than it was with the old design?
Editing: How is the experience of editing? (Remember, your edits will be seen by everyone, whether they are testing the beta or not.)
Template editing: Assuming you have account privileges, how is the experience of editing templates? (Again, remember that your edits affect all users.)
Responsive Design: The new design supports many different screen resolutions. How is the experience of using MDN on a tablet, phone, or other device?

Sharing feedback / Reporting Bugs

Let us know what you think! Bug reports, change requests and general feedback are all welcome. The more feedback you share, the better the design will be.

Before anything else, please file one bug for each piece of feedback you want to share. We would love to hear from you on IRC and through our mailing lists, but if you have not already filed a bug we will politely ask you to do so. Remember to always use this form, as it will group feedback appropriately and ensure that the team sees it.

Follow up on Bugs / Feedback

A couple times each week, we'll send out the list of bugs that are new and need to be categorized (blocks launch or does not) to the mdn@lists.mozilla.org mailing list (which is used to prioritize work on MDN and is open for anyone to participate). Bugs will be discussed there and the team can, collectively, decide what needs to be fixed before the redesign launches to the general public. We also will have a weekly, open meeting to make calls on anything that is stalled. Meetings are held every Tuesday at 17:00 UTC (10am PST) on IRC in #devmo.

Following development in real time

If you want to stay in the loop on a bug or a set of bugs, be sure to add yourself to the "cc" list. Designers and developers update bugs with discussions and decisions as they go. A github robot will automatically comment on bugs when corresponding code is merged into the master line of development. Those commits are automatically pushed to the dev server every 5 minutes:

https://developer-dev.allizom.org/

The dev team pushes commits to stage and production servers when the code is ready. You can see which commits are on the stage & production servers here:

http://mzl.la/mdn_whats_deployed

Commits also often include numbers of bugs that you can visit to see relevant discussions.

Weekly Meeting Notes

General Questions

You can join the conversation in IRC.

#mdn for general discussion
#devmo for docs & content
#mdndev for platform coding

You can also join our mailing lists.

dev-mdc@mozilla.org for docs & content
dev-mdn@mozilla.org for platform coding

Thanks!

We are very excited to be launching the beta of this new design, and are even more excited to be working with you to make it better. Thank you for all of your feedback.

@@ Line 1: / Line 1: @@
-MDN is undergoing a major redesign with improved design, layout, page customization options and navigation. To ensure that the redesign is the best it can be, we have made the design available to anyone who would like to help with beta testing. Remember that this is a beta. You can expect some bumps in the road, which we will work to correct them over time.
+<div class="toclimit-2">__TOC__</div>
-We would love for you to go around the site and take a look at everything. Try reading documentation, editing pages and making other site contributions. Remember that even though you will see our new design, you will be working with the same documentation everyone else sees. Any changes you make will be seen by all users, whether they are testing the beta or not.
+The MDN redesign launched on December 9, 2013. While the beta testing phase is over, we are welcoming feedback on the live redesign site.
-== Overview of changes ==
+MDN is undergoing a major redesign with improved visual style, layout, page customization options, navigation, and platform features. To ensure that the redesign is the best it can be, we have made it available to anyone who would like to help with beta testing. Remember that this is a beta, so while we are correcting issues quickly, you may discover some bumps along the way.
-The main difference you will notice are the changes that have been made to visual style and layout, including a new homepage, new navigation and various other improvements. Additionally, some topics like [Firefox OS] and [Apps] are now represented as Zones, documentation sections with improved landing pages and navigation. Finally, this new design includes major new platform features, such as improved search.
+== How to become an MDN beta tester ==
-== Testing suggestions ==
+* Login into [http://developer.mozilla.org MDN].
+* [http://developer.mozilla.org/profile/edit Edit your profile].
+* Check the beta user checkbox.
-Looking for some ideas? Try testing out the following.
+== Change overview ==
-* Documentation: Read our documentation just as you normally would. Pay attention to code samples, images and videos.
+The most obvious differences include the new visual style and the new layout. Updates have also been made to the homepage, to site navigation, and to major features like site search. Additionally, some topics like ''Firefox OS'' and ''Web Apps'' are now represented as '''Zones''', documentation sections with improved landing pages and a new secondary navigation sidebar.
-** Some documentation, especially lesser-known documentation, still needs to be updated to fit with the new site design and layout. Let us know if you come across anything that looks off.
-* Homepage: Is the homepage content valuable to you? How about the positioning, size and style of this content?
+== Testing ==
+We would love for you to go around the site and take a look at everything. Try reading documentation, editing pages and making other site contributions. Remember that even though you will see our new design, you will be working with the same documentation everyone else sees. Any changes you make will be seen by all users, whether they are testing the beta or not. So as part of your testing, please don't randomly change or delete content!
+=== Suggestions ===
+Looking for some ideas of things to do? Try testing out the following:
+* Documentation: Read our documentation just as you normally would. Pay attention to code samples, images, and videos. Some documentation, especially lesser-known documentation, has not yet been updated to fit with this new design. Let us know if you come across anything that doesn't look right.
+* Homepage: Is the content of the homepage valuable to you? How about the positioning, size and style of this content?
 * Navigation: Try getting around using only major site navigation. Can you find the information you need?
-* Search: Try out the improved search. Consider both the experience of searching and the quality of search results.
+* Search: Try out the improved search system. Consider both the experience of searching and the quality of search results.
-* Performance: Is performance better or worse than it was in the old design?
+* Performance: How is performance? Is it better or worse than it was with the old design?
 * Editing: How is the experience of editing? (Remember, your edits will be seen by everyone, whether they are testing the beta or not.)
-* Template editing: Assuming you have the account privilege, how is the experience of editing templates? (Again, remember that your edits will be seen by everyone.)
+* Template editing: Assuming you have account privileges, how is the experience of editing templates? (Again, remember that your edits affect all users.)
-* Responsive Design: The new design supports many different form factors. How is the experience of using MDN on a tablet, phone, or other device?
+* Responsive Design: The new design supports many different screen resolutions. How is the experience of using MDN on a tablet, phone, or other device?
+== Sharing feedback / Reporting Bugs ==
+Let us know what you think! Bug reports, change requests and general feedback are all welcome. The more feedback you share, the better the design will be.
+'''Before anything else, please [http://mzl.la/mdn-redesign-feedback file one bug for each piece of feedback you want to share]. We would love to hear from you on IRC and through our mailing lists, but if you have not already filed a bug we will politely ask you to do so. Remember to always use this form, as it will group feedback appropriately and ensure that the team sees it.'''
+== Follow up on Bugs / Feedback ==
+A couple times each week, we'll send out the list of bugs that are new and need to be categorized (blocks launch or does not) to the [https://lists.mozilla.org/listinfo/mdn mdn@lists.mozilla.org] mailing list (which is used to prioritize work on MDN and is open for anyone to participate). Bugs will be discussed there and the team can, collectively,  decide what needs to be fixed before the redesign launches to the general public. We also will have a weekly, open meeting to make calls on anything that is stalled. Meetings are held every Tuesday at 17:00 UTC (10am PST) on IRC in #devmo.
+*[https://bugzilla.mozilla.org/showdependencytree.cgi?id=925144&hide_resolved=1 Launch blocking bugs]
+*[https://bugzilla.mozilla.org/showdependencytree.cgi?id=910513&hide_resolved=1 New/to be processed bugs]
+*Bugs that can be [https://bugzilla.mozilla.org/showdependencytree.cgi?id=925145&hide_resolved=1 addressed after launch]
+=== Following development in real time ===
+If you want to stay in the loop on a bug or a set of bugs, be sure to '''add yourself to the "cc" list'''. Designers and developers update bugs with discussions and decisions as they go. A github robot will automatically comment on bugs when corresponding code is merged into the master line of development. Those commits are automatically pushed to the dev server every 5 minutes:
+https://developer-dev.allizom.org/
+The dev team pushes commits to stage and production servers when the code is ready. You can see which commits are on the stage & production servers here:
+http://mzl.la/mdn_whats_deployed
+Commits also often include numbers of bugs that you can visit to see relevant discussions.
-== Sharing feedback ==
+===Weekly Meeting Notes===
+*[https://wiki.mozilla.org/MDN/Development/Redesign/Testing/03DecMeeting 03 December, 2013]
+*[https://wiki.mozilla.org/MDN/Development/Redesign/Testing/26NovMeeting 26 November, 2013]
+*[https://wiki.mozilla.org/MDN/Development/Redesign/Testing/19NovMeeting 19 November, 2013]
+*[https://wiki.mozilla.org/MDN/Development/Redesign/Testing/12NovMeeting 12 November, 2013]
+*[https://wiki.mozilla.org/MDN/Development/Redesign/Testing/05NovMeeting 05 November, 2013]
+*[https://wiki.mozilla.org/MDN/Development/Redesign/Testing/29OctMeeting 29 October, 2013]
+*[https://wiki.mozilla.org/MDN/Development/Redesign/Testing/15OctMeeting 15 October, 2013]
-Let us know what you think! Bug reports, change requests and general feedback are all welcome. There are many ways to get in touch with us. The more feedback we get, the better the design will be.
+== General Questions ==
+You can join the conversation in [[IRC|IRC]].
+* #mdn for general discussion
+* #devmo for docs & content
+* #mdndev for platform coding
-* Before anything else, please [http://mzl.la/mdn-redesign-feedback file one bug for each piece of feedback you want to share]. We would love to hear from you on IRC and through our mailing lists, but if a bug is not already filed we will probably ask you to do so. Remember to use this form for all redesign feedback, as it will group feedback appropriately and ensure that the team sees it.
+You can also join our mailing lists.
-* Join the conversation in [[IRC|IRC]]. You can meet us in #mdn for general discussion, #devmo for discussion about documentation and #mdndev for discussion about development progress.
+* [https://lists.mozilla.org/listinfo/dev-mdc dev-mdc@mozilla.org] for docs & content
-* Join our mailing lists. Staff documentation writers can be reached on [https://lists.mozilla.org/listinfo/dev-mdc dev-mdc@mozilla.org] and platform developers can be reached on [https://lists.mozilla.org/listinfo/dev-mdn dev-mdn@mozilla.org]. When contacting the team through these mailing lists, please be specific and group your feedback into paragraphs or numbered lists.
+* [https://lists.mozilla.org/listinfo/dev-mdn dev-mdn@mozilla.org] for platform coding
 == Thanks! ==
 We are very excited to be launching the beta of this new design, and are even more excited to be working with you to make it better. Thank you for all of your feedback.