Live data from Hacker News

Documenting the Web together

blogs.windows.com

31–40 of 212 posts

Re: Documenting the Web together

#31
post #23

Great, while they are at it can Google please downgrade the extremely spammy w3schools or at least allow me to remove certain websites from my searches. There are so many better resources out there...

https://www.google.com/search?q=querySelectorAll+-site:w3sch... this syntax has been supported for many years

I also like the "Personal Blocklist" extension for Chrome: https://chrome.google.com/webstore/detail/personal-blocklist...

Re: Documenting the Web together

#32
post #23

Great, while they are at it can Google please downgrade the extremely spammy w3schools or at least allow me to remove certain websites from my searches. There are so many better resources out there...

https://www.google.com/search?q=querySelectorAll+-site:w3sch... this syntax has been supported for many years

I think the parent meant to exclude some domains from every search. I would love that too. If I have to add "-site:somedomain.com" (and maybe even many of them!) it takes less effort ignore them in the result

Re: Documenting the Web together

#33
post #21
post #3

Good Bye w3schools.com ?

w3schools.com is a great resource. I prefer it when I need a quick refresher on an HTML element because it's especially good for having short, simple examples I can copy and paste. MDN tends to be verbose and technical. It's good when you need to know everything in detail, but often I need a quick refresher and a simple example and for that w3schools.com always seems to have better content. Compare these two pages fo…

The whole point of documentation though is for it to be complete, technical and well explained. Not to have copy-pastable examples.

W3schools is neither good documentation or good examples though.

Re: Documenting the Web together

#34
This news sounds great to me, but I feel like I don't understand what's happening behind the curtain and don't grasp the second-order consequences. What would motivate them? I wonder what the political motives are (industry politics, not the other kind that we won't mention here).

Could this eventually displace standards bodies such as WHATWG and W3C? If the Product Advisory Board of Mozilla, Google, and Samsung agree on a standard and publish it at MDN, will that become as official, at least de facto, as a standard published by W3C? I do see W3C is mentioned as a participant.

Also, for the sake of argument (and IMHO, of realism) let's assume that Google, who can virtually set web standards themselves these days, isn't doing this for a purely altruistic motive of supporting the open web. Why would they give up the 'soft power' of writing their own documentation for their own standards?

Re: Documenting the Web together

#35

Great, while they are at it can Google please downgrade the extremely spammy w3schools or at least allow me to remove certain websites from my searches. There are so many better resources out there...

I’ll never/rarely click a w3schools link, but I do find MDN to be quite difficult to read with it’s pages being quite technical and terse. W3schools is quite pragmatic with providing a reference for CSS properties. I hope these extra resources will let MDN improve on this.

Agreed. Even simple concepts can have overly technical examples on MDN. Sometimes it causes me to overthink a simple script.

Re: Documenting the Web together

#36

Great, while they are at it can Google please downgrade the extremely spammy w3schools or at least allow me to remove certain websites from my searches. There are so many better resources out there...

I've never understood the hate for w3schools. I've always found them to be extremely useful. I like that usage examples is the focus of their site. I find that more useful than wordy documentations that more advanced references provide.

Re: Documenting the Web together

#37

Great, while they are at it can Google please downgrade the extremely spammy w3schools or at least allow me to remove certain websites from my searches. There are so many better resources out there...

I’ll never/rarely click a w3schools link, but I do find MDN to be quite difficult to read with it’s pages being quite technical and terse. W3schools is quite pragmatic with providing a reference for CSS properties. I hope these extra resources will let MDN improve on this.

I agree. I feel like going to MDN to quickly look up syntax is like trying to kill a fly with a handgun.

Re: Documenting the Web together

#38
post #23

Earlier quoted context omitted.

https://www.google.com/search?q=querySelectorAll+-site:w3sch... this syntax has been supported for many years

I think the parent meant to exclude some domains from every search. I would love that too. If I have to add "-site:somedomain.com" (and maybe even many of them!) it takes less effort ignore them in the result

Bookmark that. I use the following:

https://www.google.com/webhp?hl=en&newwindow=1&num=30

I remove the ei identifier from the bookmark. I guess this is a unique ID that makes it possible for google to keep following me if I happen to bookmark it. Eg:

ei=Vo_n34buB9Cabdedfk6gO

And I happen to like the W3school examples, especially CSS. They've helped me many times. I don't see the problem with them, but please ignore them if you don't like it.

Re: Documenting the Web together

#39
post #14

For me, as an experienced front-end-focussed developer, MDN has been my go-to website for quick spec references. MDN has all I need to know, and I know my way around. However, I've been in teams where the less-experienced developers went to W3C Schools to see how they should implement some feature. And to be honest, I cannot completely blame them. W3C Schools shows directly what you need to know and how the API you a…

I've been that less experienced developer, using w3schools would save a minute or two on certain searches. Now I enjoy going to MDN and learning a few extra things on a given topic, or reinforcing an existing understand, via MDN. Sometimes i'll lose 15 minutes crawling a few tangential links - worth.

Re: Documenting the Web together

#40
post #36

Great, while they are at it can Google please downgrade the extremely spammy w3schools or at least allow me to remove certain websites from my searches. There are so many better resources out there...

I've never understood the hate for w3schools. I've always found them to be extremely useful. I like that usage examples is the focus of their site. I find that more useful than wordy documentations that more advanced references provide.

http://www.w3fools.com/ top of the page summarizes the situation:

> When W3Fools was launched in 2011, the state of documentation for developers was poor. This site documented many content errors and issues with the W3Schools website. The Mozilla Developer Network was around but it did not have much support at the time.

> Today, W3Schools has largely resolved these issues and addressed the majority of the undersigned developers' concerns. For many beginners, W3Schools has structured tutorials and playgrounds that offer a decent learning experience. Do keep in mind: a more complete education will certainly include MDN and other reputable resources.

MDN would greatly benefit from more soft documentation and a playground setup similar to W3Schools

Post reply on HN