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

no edit summary
No edit summary
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.
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.


== How you can help ==
== How you can help ==


Remember that even though you will see our new design, you will be working with the same documentation. Any changes you make will be seen by all users, whether they are seeing the new design or not.
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.
 
Once the redesign is enabled, we would love you to go around the site and have a look at everything, as well as editing some pages and making some other site contributions. Please let us what you think of the redesign, what is not working, and what could use improvement.


=== Testing suggestions ===
=== Testing suggestions ===


Looking for some ideas? Try testing out the following. Bug reports, change requests and other feedback is welcome.
Looking for some ideas? Try testing out the following.


* Read documentation and follow links. Pay attention to code samples, images and videos. Act just as you normally would if you were reading documentation.
* Documentation: Read our documentation just as you normally would. Pay attention to code samples, images and videos.
* Try our improved search. Pay attention to both the experience of searching and the quality of the search results.
** 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.
* Edit a page (remember that your edits will be seen by everyone, whether they are testing the beta or not)
* Homepage: Is the homepage content valuable to you? How about the positioning, size and style of this content?
* Edit a template, if your account has this privilege (again, remember that these edits will be seen by everyone)
* 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.
* Performance: Is performance better or worse than it was in 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.)
* Responsive Design: The new design supports many different form factors. How is the experience of using MDN on a tablet, phone, or other device?


=== Sharing feedback ===
=== Sharing feedback ===
Line 23: Line 26:
* 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.
* 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.
* 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].
* 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].
What kind of feedback we are looking for? We are interested in:
* ''Your overall feeling'': keep in mind it is an early beta and is a work in progress. It isn't a beta, we won't change anything until the launch.
* ''Navigational problems'': the first goal is to be able to reach all the information. We know that it was difficult with the old design, we hope it is better, but we may forgotten something.
* ''Visual problems and glitches'':
** on the home page: Does the positioning of the element suit your needs? Some elements are emphasized by the color scheme or the position on the page: are these the right ones?
** on the zone landing pages
** in articles: we have in-content element that may not fit well, we are interested in a list. Especially if you use a lesser known part of the MDN that is not the Open Web document where we probably have missed it. We have added quick links, but these are experimental: feel free to tell us if they help you or not.
** at different sizes. Keep in mind that even if we aim to support small screens, we are not done there yet. But anything 10" or greater shouldn't show major problem.
* ''Speed'': we don't have performed any specific optimization here, but there shouldn't be less good now than before. If you noticed strange things, be sure to tell us.
* ''Search'': we have a new search engine, that does not use Google anymore, so we are specifically interested in the quality of the results. We have added the ability to set filters. Try using them, tell us if they work, if the quality of results is good and so on. Also is it easy to get to the search? Is there specific problems you encounter when typing your search query?


== Final word ==
== Final word ==
Confirmed users
1,193

edits