Re:The Mozilla Developer Network has a New Face
by modeless on Monday December 09, 2013 @04:06PM
(#6876979)
Is it going to get faster? I find that MDN pages load much, much slower than e.g. w3schools, which probably explains some or all of their failure to grab the top spot on most Google searches.
Re:The Mozilla Developer Network has a New Face
by groovecoder on Monday December 09, 2013 @04:29PM
(#6877154)
MDN dev here. Page-load time is one of our immediate next goals. Tons of traffic to our document view and lots of potential back-end processing on each doc kinda sucks. But, we're using New Relic now and hoping to tackle things iteratively as we go.
Re:The Mozilla Developer Network has a New Face
by modeless on Monday December 09, 2013 @04:46PM
(#6877259)
Please add caching of full rendered wiki pages for logged-out users. I'd much rather get a cached page from yesterday in 100ms than wait 10 seconds for today's edits to be rendered.
Re:The Mozilla Developer Network has a New Face
by groovecoder on Monday December 09, 2013 @05:01PM
(#6877357)
Hmm ... it should work that way now. In fact, only admin users can force a page to refresh its cached content.
Though we are getting a spike in traffic with the redesign launch, New Relic still reports app server response times of <600ms. But WebPagetest confirms really slow load times. [1]
Re:The Mozilla Developer Network has a New Face
by iagooar on Monday December 09, 2013 @05:37PM
(#6877574)
I'm getting response times of 4-5 seconds, which I think is a lot.
This is mainly static content you got there, it's the easiest scenario for aggressive content caching. Just throw in a good Memcached server and serve the whole page from cache. Add some good expiration headers + etags and the website will fly. Unless you have problems with request queueing, which would be a completely different topic.
Re:The Mozilla Developer Network has a New Face
by subsection1h on Monday December 09, 2013 @10:07PM
(#6878759)
> use a serif font for the main text,really,you can keep the headlines sans.
All the web usability studies and web design books I've read that address typography have stated that most people prefer sans-serif typefaces on screens. And the typefaces used by all the top sites reflect this.
Re:The Mozilla Developer Network has a New Face
by ggreer on Tuesday December 10, 2013 @06:12AM
(#6880064)
I don't have a strong preference either way, but it's important to note that those recommendations came before retina displays. Serif fonts can't be rendered accurately on low-DPI displays. As more people get high-DPI displays, I bet serif fonts will be used more in body text.
Re:The Mozilla Developer Network has a New Face
by ggreer on Tuesday December 10, 2013 @12:34PM
(#6882116)
Umm... That's what I said. "As more people get high-DPI displays, I bet serif fonts will be used more in body text." I was making a prediction, not stating that designers should use one or the other.
Re:The Mozilla Developer Network has a New Face
by yati on Tuesday December 10, 2013 @04:32AM
(#6879770)
If I had to suggest a change in the typography, I'd suggest the opposite. The headings(large text) can have serifs. But the bulk of the body should definitely be sans. Serifs add too much clutter when the font is small.
Re:The Mozilla Developer Network has a New Face
by db48x on Tuesday December 10, 2013 @07:02PM
(#6884846)
Add this to your userContent.css: <http://db48x.net/MDN-fix.css>. It fixes the whitespace problems, but I haven't touched fonts. Font size is best corrected by zooming in; Firefox will even remember your zoom level across the whole domain, so you only have to do that once.
Re:The Mozilla Developer Network has a New Face
by mintplant on Monday December 09, 2013 @07:22PM
(#6878113)
That sounds like a good idea, actually. Why not? Generate and store each page each time it's edited, then serve from the static copies. There will be a lot more reads than there are writes anyway.
Re:The Mozilla Developer Network has a New Face
by groovecoder on Tuesday December 10, 2013 @08:56AM
(#6880690)
We can't generate the whole thing statically, because there are parts of the interface that change with user state.
We do render the HTML for article content, which includes many scripting templates.
We're seeing a lot of interest in the static/caching side of the site. I wonder if we should do a public article about it and invite people to help us improve it.
Re:The Mozilla Developer Network has a New Face
by chalst on Wednesday December 11, 2013 @04:16AM
(#6886701)
Can you not serve a static page and then have Javascript fetch the additional, user state-dependent content? At the very least, that will reduce latency for some content.
The public article will surely be interesting even if it is not all that useful...
Re:The Mozilla Developer Network has a New Face
by nfm on Monday December 09, 2013 @04:25PM
(#6877135)
Wow, you weren't kidding - 10164ms for me. From what I can tell, there's not much dynamic content in the page. Static caching would go a long way there. I'm sure they'd appreciate a pull request from someone with some Django chops! https://github.com/mozilla/kuma
Re:The Mozilla Developer Network has a New Face
by chad_oliver on Monday December 09, 2013 @04:55PM
(#6877329)
Since most pages would be read far more often than they are written, you could probably get good results by 'compiling' the page to a static cache after each edit.
Re:The Mozilla Developer Network has a New Face
by iagooar on Monday December 09, 2013 @05:41PM
(#6877604)
I would go that way too. Static content export, put a CDN in front of it, and response times will get < 100ms, even < 80ms.
I have done some experiments with static exports using dynamic frameworks like Rails, and man, it really makes a huge difference. Of course, if your content is mainly static.
Re:The Mozilla Developer Network has a New Face
by lmorchard on Tuesday December 10, 2013 @08:50AM
(#6880657)
Rendering page content after edits is exactly what we do. Most page views are served up from a pre-built cache, either from a straight caching HTTP proxy or from a single DB column.
Re:The Mozilla Developer Network has a New Face
by shabble on Monday December 09, 2013 @07:07PM
(#6878038)
No, only views which hit a stale copy of the rendered page and have to call that render() function. Normal views would (I imagine, I haven't traced it back) use the get_rendered() instead, which checks that the cached version is current and schedules a re-rendering (which obviously requires DB writes anyway) if necessary.
Re:The Mozilla Developer Network has a New Face
by handsomeransoms on Monday December 09, 2013 @06:01PM
(#6877709)
Yeah - looks like it's emulating a lock so only one page can be rendered at a time (plus the overhead for database IO to maintain the lock). Is this really the best way to go about this?
Re:The Mozilla Developer Network has a New Face
by shabble on Monday December 09, 2013 @07:09PM
(#6878056)
Unless I'm missing something important, it's locking so the same page can only be rendering once at a time; if another request that would cause a rebuild comes in while a previous rebuild is still in progress, it gets bounced.
Re:The Mozilla Developer Network has a New Face
by avidal on Monday December 09, 2013 @05:55PM
(#6877684)
Seems to me it's actually writing to the database twice for each page view; once to update the render_started_at property on #845, and once again on #881.
Re:The Mozilla Developer Network has a New Face
by theandrewbailey on Monday December 09, 2013 @04:32PM
(#6877169)
The sad part is that I don't mind waiting that long. For most things, I will skip Google entirely and go directly to MDN and not waste my time sorting through the documentation light results from W3schools. Someday, I might start using Web Platform Docs too.
Re:The Mozilla Developer Network has a New Face
by cmelbye on Monday December 09, 2013 @06:06PM
(#6877732)
It's interesting that they decided to write their own wiki. If I remember correctly, they used to use MediaWiki which has fairly straightforward built-in support for scaling used by Wikipedia and its sister sites. (Replicate your database so it sends all read queries to replicas, set up memcached to cache I18n strings and parser results, use Squid so that logged out users don't even hit the app servers, enable APC, etc.) I'd be interested in knowing why they went with the option of a rewrite.
Re:The Mozilla Developer Network has a New Face
by lmorchard on Tuesday December 10, 2013 @08:48AM
(#6880643)
The site started on MediaWiki. But, probably around 7 years ago, it switched over to a platform called DekiWiki, later renamed to MindTouch.
This is way over-simplifying it, but: MindTouch looks like a fork of MediaWiki (PHP) that's had all the database calls replaced by requests to a local web service running on .NET, with a Lua-based document scripting system (DekiScript) added on.
However, MDN ran all this on Linux servers - rather than Windows servers - so our installation was rather unusual. Eventually, the company behind the software decided to drop support for our kind of setup. So, we decided to move over to software we could support in-house, and launched it around June 2012.
What we have now started from the Django-based wiki that runs support.mozilla.org, called kitsune. From there, we worked on getting some practical feature parity with MindTouch. I added a node.js-based document scripting service (KumaScript) that mostly replaced DekiScript for our needs. We worked up some migration scripts, and moved the whole thing over.
It's admittedly kind of an evolutionary mess, at this point. But, at least it's our mess.
Re:The Mozilla Developer Network has a New Face
by soapdog on Monday December 09, 2013 @08:28PM
(#6878398)
MDN focus is on having the best and most complete content. w3schools rank higher on google search but their content is not the best one, and sometimes it is too shallow.
Those working with the web should use better documentation than w3schools, thats a quick tutorial site.
Also MDN is from Mozilla so it is all open source and we can all contribute and help speed things up ;-)
Re:The Mozilla Developer Network has a New Face
by modeless on Thursday December 12, 2013 @05:36PM
(#6897760)
Cool! All the issues I see in the list so far are client issues, but the major issue I see is server-side. Server-side HTML rendering ought to take 200ms or less (a lot less for cached pages), but according to Chrome's dev tools, most of the documentation wiki pages take 500-10000ms to render. Client-side optimizations aren't going to help much until that's fixed.
Re:The Mozilla Developer Network has a New Face
by bad_user on Monday December 09, 2013 @05:39PM
(#6877588)
The new design is sexy-ish, but I think readability suffers because:
1. the contrast is too low, for example that blue colour of links on white background is too light, hurts my eyes
2. the font-size is too small, especially in combination with the poor contrast. 14px is too small on today's desktops, should be 16px ... better yet, it should be left at 100% as that scales better. On the other hand I like the usage of Open Sans, it's a readable font and ensures availability on all OSes
3. some pages are too slow to load. MDN is a great reference and decreasing latency should be a priority.
Re:The Mozilla Developer Network has a New Face
by kamjam on Tuesday December 10, 2013 @09:36AM
(#6880914)
I hate this bandwagon of everyone jumping onto the MS Metro UI look for everything. The old site wasn't perfect, but please come up with something original.
Re:The Mozilla Developer Network has a New Face
by bcoates on Monday December 09, 2013 @05:18PM
(#6877452)
I think the new color scheme is nice, but the contrast is way too low for the tiny, low-weight font they're using. A bold or larger text or increasing the contrast a little would make it work. To meet http://accessibility.psu.edu/contrasthtml they'll probably have to do all three.
Re:The Mozilla Developer Network has a New Face
by jakub_g on Monday December 09, 2013 @04:53PM
(#6877310)
I have to admit I liked the previous color scheme much more too. White / light blue background + gray text (~#4D). Why is it so popular to make low-contrast sites these days? It's inexplicable to me, other than just the designers' craving for change (yes it probably has all the contrast coefficients within the norms, but it doesn't mean this couldn't be made better).
Re:The Mozilla Developer Network has a New Face
by Daiz on Monday December 09, 2013 @04:11PM
(#6877022)
I never really thought about it before, but this new layout immediately made me realize that there's just a single letter difference between MDN and MSDN... the layout is rather similar to what the latter was using a while back. Not that it's a bad thing or anything, just thought it was amusing. MDN is a fantastic resource, so it's great to see some love and care being poured into it.
Re:The Mozilla Developer Network has a New Face
by X4 on Monday December 09, 2013 @07:34PM
(#6878172)
wow, seems like it's true that there are always two people with the same idea, somewhere on earth. Or, how they would say it in Germany: "Two idiots, same idea."
To me, the MDN to MSDN portal similarity is also a striking symbol of the Mozilla & Microsoft partnership. The design, even looks like it's a little Windows 8 inspired, from my angle.
Re:The Mozilla Developer Network has a New Face
by currysausage on Monday December 09, 2013 @08:40PM
(#6878437)
Put "Shared knowledge for the open web" on just one line. It will look less clumsy, plus there will be more content "above the fold." (More content above the fold would be great on other pages, too.)
Generally speaking, dealing with developer docs, "less is more" is almost always true. I love elaborate design, but here, visual clarity and speed are key. Finding things quickly is more important than beautiful fonts and graphics. Therefore, take an "un-design" approach. This iteration of MDN certainly is a step into the right direction.
I love Open Sans, but, at least on Windows, Arial is more legible (and doesn't have to be downloaded first.)
Menu fade effects are cool as long as I perceive them subliminally; 400ms (?) feels extremely sluggish.
As others have noted, page load times still need to improve considerably. In order to find my way around tech docs, I have to browse a lot; therefore, pages can't load fast enough. Grab a copy of "High Performance Web Sites" and heed the rules outlined there. 9 CSS files are not okay! >10 JS files are not okay! (Why would you even need that much code for simple docs pages?)
Re:The Mozilla Developer Network has a New Face
by Ygg2 on Tuesday December 10, 2013 @11:19AM
(#6881544)
Here is my analysis of the page.
My look at loading times found these biggest offenders:
GET / developer.mozilla.org 2153ms (767ms connecting, 499ms wait) 23.42KB
GET include.js login.persona.org 2151ms (1921ms connecting, 230ms wait) 16.87KB
Also there is a bunch of png like "persona-person-white.png" and a bunch of pictures like "*_screenshot_1_thumb" that take about ~1000ms each, but are taken in parallel.
Re:The Mozilla Developer Network has a New Face
by mistercow on Monday December 09, 2013 @04:31PM
(#6877165)
I hate to post the typical "why are they focusing on adding new features before making it actually work" kind of comment, but this is that comment. I like MDN, but it drives me nuts how often I click an internal link on it and either get any number of server errors or a 404 page.
Re:The Mozilla Developer Network has a New Face
by lillycat on Monday December 09, 2013 @04:40PM
(#6877217)
Could you open a bug the next time it happens (with a link to the page)? It would help in diagnosing the problem (client-side, server-side, doc missing, ...)
Re:The Mozilla Developer Network has a New Face
by bad_user on Monday December 09, 2013 @05:48PM
(#6877651)
Your profile is not immediately available after login with persona.org, as you also have to provide a username (in case you don't have one already). You're logged in only after providing a username in this second step.
For example, a page like this takes nearly 10 seconds to render on the server before the browser receives a single byte: https://developer.mozilla.org/en-US/docs/Web/Reference/Event...
MDN's content is already good. I'd prefer to see effort put into speeding it up rather than adding more features.
https://developer.mozilla.org/en-US/docs/Project:MDN/Plans_a...
Though we are getting a spike in traffic with the redesign launch, New Relic still reports app server response times of <600ms. But WebPagetest confirms really slow load times. [1]
If anyone finds some gross offenders of page performance, please file a bug: http://bugzilla.mozilla.org/form.mdn or better yet - send a pull request: https://github.com/mozilla/kuma !
[1] http://www.webpagetest.org/result/131209_Z0_1Q09/
This is mainly static content you got there, it's the easiest scenario for aggressive content caching. Just throw in a good Memcached server and serve the whole page from cache. Add some good expiration headers + etags and the website will fly. Unless you have problems with request queueing, which would be a completely different topic.
- darken the text, low contrast destroys eyesight.
- make the text bigger for god sake
- use a serif font for the main text,really,you can keep the headlines sans.
- your website has a big whitespace/negative space balance problem.
I mean,i dont understand designers today. Do they care about readability? or that a site look fancy on their shiny new mac ?
As for performance problems i would suggest moving to a static site generator, a doc is the perfect use case.
All the web usability studies and web design books I've read that address typography have stated that most people prefer sans-serif typefaces on screens. And the typefaces used by all the top sites reflect this.
We do render the HTML for article content, which includes many scripting templates.
We're seeing a lot of interest in the static/caching side of the site. I wonder if we should do a public article about it and invite people to help us improve it.
The public article will surely be interesting even if it is not all that useful...
https://developer.mozilla.org/en-US/docs/Project:MDN/Kuma
I have done some experiments with static exports using dynamic frameworks like Rails, and man, it really makes a huge difference. Of course, if your content is mainly static.
https://github.com/mozilla/kuma/blob/master/apps/wiki/models...
http://docs.webplatform.org/
That said, I like both the new and old designs, and as someone who's spent a lot of time on MDN recently, I've personally never noticed it to be slow.
This is way over-simplifying it, but: MindTouch looks like a fork of MediaWiki (PHP) that's had all the database calls replaced by requests to a local web service running on .NET, with a Lua-based document scripting system (DekiScript) added on.
However, MDN ran all this on Linux servers - rather than Windows servers - so our installation was rather unusual. Eventually, the company behind the software decided to drop support for our kind of setup. So, we decided to move over to software we could support in-house, and launched it around June 2012.
What we have now started from the Django-based wiki that runs support.mozilla.org, called kitsune. From there, we worked on getting some practical feature parity with MindTouch. I added a node.js-based document scripting service (KumaScript) that mostly replaced DekiScript for our needs. We worked up some migration scripts, and moved the whole thing over.
It's admittedly kind of an evolutionary mess, at this point. But, at least it's our mess.
Those working with the web should use better documentation than w3schools, thats a quick tutorial site.
Also MDN is from Mozilla so it is all open source and we can all contribute and help speed things up ;-)
https://github.com/mozilla/kuma/issues?labels=performance&pa...
1. the contrast is too low, for example that blue colour of links on white background is too light, hurts my eyes
2. the font-size is too small, especially in combination with the poor contrast. 14px is too small on today's desktops, should be 16px ... better yet, it should be left at 100% as that scales better. On the other hand I like the usage of Open Sans, it's a readable font and ensures availability on all OSes
3. some pages are too slow to load. MDN is a great reference and decreasing latency should be a priority.
HN makes the cut.
To me, the MDN to MSDN portal similarity is also a striking symbol of the Mozilla & Microsoft partnership. The design, even looks like it's a little Windows 8 inspired, from my angle.
(There's no assessment involved)
They changed everything, even the friggin logo is blue now. What was wrong with the old look?
How can I get it back?
I've posted about it here: http://lebgeeks.com/forums/viewtopic.php?id=14889
Generally speaking, dealing with developer docs, "less is more" is almost always true. I love elaborate design, but here, visual clarity and speed are key. Finding things quickly is more important than beautiful fonts and graphics. Therefore, take an "un-design" approach. This iteration of MDN certainly is a step into the right direction.
I love Open Sans, but, at least on Windows, Arial is more legible (and doesn't have to be downloaded first.)
Menu fade effects are cool as long as I perceive them subliminally; 400ms (?) feels extremely sluggish.
As others have noted, page load times still need to improve considerably. In order to find my way around tech docs, I have to browse a lot; therefore, pages can't load fast enough. Grab a copy of "High Performance Web Sites" and heed the rules outlined there. 9 CSS files are not okay! >10 JS files are not okay! (Why would you even need that much code for simple docs pages?)
though it doesn't include JavaScript (browser related API, only node.js) as does MDN; and no PHP or MySQL
My look at loading times found these biggest offenders:
Also there is a bunch of png like "persona-person-white.png" and a bunch of pictures like "*_screenshot_1_thumb" that take about ~1000ms each, but are taken in parallel.It's in the drop down list when I hover the main menu, but I can't seem to navigate to it otherwise.
[0] https://developer.mozilla.org/en-US/docs/Web
It's basically a LMGTFY search on whatever you put after the slash, for example - http://mdn.io/css%20transitions.
http://bugzilla.mozilla.org/form.mdn
https://developer.mozilla.org/en-US/ vs http://msdn.microsoft.com/en-us/default.aspx
Old design was better!
https://github.com/mozilla/kuma/tree/master/apps/search
Or file a bug: https://github.com/mozilla/persona/issues/new