|
May I join the laughing choir ? MSDN docs for devs, and forums, are beyond dis-organized, incoherent, etc.
One reason for this, imho, is that those who manage/edit/write examples/content for devs are most likely not "best of breed." Another is the spate of amateur helpers (not MS employees) who knock themselves out (and concuss other users) for the glory of merit badges ... without, imho, the kind of self-review/moderation that you find here, and on StackOvwrFlow.
Of course, there are rare exceptions: when you see an article by a "guru" like Michaelis on the MSDN on-line magazine, you know you'll get quality.
Bill the Grinch
«... thank the gods that they have made you superior to those events which they have not placed within your own control, rendered you accountable for that only which is within you own control For what, then, have they made you responsible? For that which is alone in your own power—a right use of things as they appear.» Discourses of Epictetus Book I:12
|
|
|
|
|
LOL, you've clearly never sought help for anything non-MS related, especially java based. Lucene, Solr, nHibernate...you name it, the documentation ranges from terrible to non-existent. Same goes for many js frameworks too, jQuery is probably the only exception and possibly one of the reasons it is so successful.
|
|
|
|
|
Quite true indeed... when the documentation and the provided examples work in the first place! Faaaarking Freeradius and the year of my life lost upon it.
GCS d-- s-/++ a- C++++ U+++ P- L+@ E-- W++ N+ o+ K- w+++ O? M-- V? PS+ PE- Y+ PGP t+ 5? X R+++ tv-- b+(+++) DI+++ D++ G e++ h--- ++>+++ y+++* Weapons extension: ma- k++ F+2 X
|
|
|
|
|
MSDN has a lot of howto-articles and is a resource I frequently visit.
Would you prefer the documentation-style of Telerik? Google?
Bastard Programmer from Hell
If you can't read my code, try converting it here[^]
|
|
|
|
|
I'd love to belt whoever wrote this rot over the head with a copy of Eats, Shoots and Leaves.
98.4% of statistics are made up on the spot.
|
|
|
|
|
Funny thing is that that original Word for Windows manual is considered a tour de force in technical manuals in both design and writing. (By contrast, the early Microsoft C manuals were awful. Yet, the Turbo C manual was excellent. And so it goes.)
|
|
|
|
|
Oh, and boo, hiss to Oxford style commas.
|
|
|
|
|
I disagree entirely. There should be no other style. Eschew obfuscation.
|
|
|
|
|
|
I don't use it because they said to so I certainly won't stop using because they say to.
|
|
|
|
|
Up-voted for its delightful bottom-note of yako-zen.
«... thank the gods that they have made you superior to those events which they have not placed within your own control, rendered you accountable for that only which is within you own control For what, then, have they made you responsible? For that which is alone in your own power—a right use of things as they appear.» Discourses of Epictetus Book I:12
|
|
|
|
|
They used to: Win32 API are documented like they descended from the heavens.
.NET and WPF documentation on the other hand... they give CP a very strong raison d'etre.
GCS d-- s-/++ a- C++++ U+++ P- L+@ E-- W++ N+ o+ K- w+++ O? M-- V? PS+ PE- Y+ PGP t+ 5? X R+++ tv-- b+(+++) DI+++ D++ G e++ h--- ++>+++ y+++* Weapons extension: ma- k++ F+2 X
|
|
|
|
|
den2k88 wrote: .NET and WPF documentation on the other hand... they give CP a very strong raison d'etre. Up-voted. Now, that's what I like: the glass is half-full version
By the same logic, we can say (and, I do say) that the quirks and inconsistencies of the various WinForm Controls enabled a thriving after-market for 3rd. party developers to provide more cohesive, integrated, Controls.
I am not familiar with WPF docs' quality, but, I suspect that the more unified design of WPF (binding model, bubbling event model, vector uber alles, etc.) might result in a more cohesive over-all result.
cheers, Bill
«... thank the gods that they have made you superior to those events which they have not placed within your own control, rendered you accountable for that only which is within you own control For what, then, have they made you responsible? For that which is alone in your own power—a right use of things as they appear.» Discourses of Epictetus Book I:12
|
|
|
|
|
BillWoodruff wrote:
I am not familiar with WPF docs' quality, but, I suspect that the more unified design of WPF (binding model, bubbling event model, vector uber alles, etc.) might result in a more cohesive over-all result. It should be... instead it's explained in separate bits and pieces hardly connecting with each other. The best tutorial for a WPF beginner is hosted here on CP, MS documentation is fragmented despite being much more verbose.
Dependency properties are great but what do they do? What use are them to me? Attached properties are wonderful but how do they impact my life as a programmer? Which are the contexts I might want to use object X? What are the objects that are meant to be used with X? All questions that go unanswered on .NET and WPF documentation which were always detailed in Win32 API.
GCS d-- s-/++ a- C++++ U+++ P- L+@ E-- W++ N+ o+ K- w+++ O? M-- V? PS+ PE- Y+ PGP t+ 5? X R+++ tv-- b+(+++) DI+++ D++ G e++ h--- ++>+++ y+++* Weapons extension: ma- k++ F+2 X
|
|
|
|
|
den2k88 wrote: Dependency properties are great but what do they do? What use are them to me? Attached properties are wonderful but how do they impact my life as a programmer? Which are the contexts I might want to use object X? What are the objects that are meant to be used with X? All questions that go unanswered on .NET and WPF documentation which were always detailed in Win32 API. To me, the types of question you ask here, rhetorically, are exactly the type of question that good developer documentation should answer ! Of course, you still need the summary info.
cheers, Bill
«... thank the gods that they have made you superior to those events which they have not placed within your own control, rendered you accountable for that only which is within you own control For what, then, have they made you responsible? For that which is alone in your own power—a right use of things as they appear.» Discourses of Epictetus Book I:12
|
|
|
|
|
Google is looking into developing a game streaming service that would allow it to stream software to a compatible Chromecast device or yet-to-be-released home console Why? Search them
|
|
|
|
|
Back in the 1800's a home console was someone who dropped by your house when you were feeling down to cheer you up. My how the times have changed. My mom always told me playing too many video games was bad for me and I had to go play outside, well all the kids back in the 1800's did was play outside and now they're all dead. Sorry Mom, evidence defuncts your theory.
|
|
|
|
|
Why do all say playing game is bad. I don't think it is BAD.Thanks for the information.
|
|
|
|
|
New data debunks several myths around which companies lead in open source contributions They're all so secretive!
|
|
|
|
|
Here is an ice cube you do not want to put in your Diet Coke: A solid lattice of oxygen atoms with protons whizzing around inside of it. This ice is not normal on Earth, but might be elsewhere. And scientists have created it in a lab. I usually think of a different phase of matter there
Yes, I'm juvenile. But Herschel should have picked a better name if he didn't want to hear my sniggering.
|
|
|
|
|
I thought it was stinging down there.
(I'll fetch my coat)
"If you don't fail at least 90 percent of the time, you're not aiming high enough."
Alan Kay.
|
|
|
|
|
It may not be the best advert for Azure that Visual Studio Team Services has been experiencing a number of serious issues over the last couple of weeks.
Service Blog – Visual Studio Team Services
Today's "Performance Degradation in West Europe" currently means that none of our team can access remote source control at all.
"If you don't fail at least 90 percent of the time, you're not aiming high enough."
Alan Kay.
|
|
|
|
|
WHY remoting a company code and services outside the company itself will always baffle me. If I'm not responsible for, cannot destroy or physically protect my data then they are not my data.
GCS d-- s-/++ a- C++++ U+++ P- L+@ E-- W++ N+ o+ K- w+++ O? M-- V? PS+ PE- Y+ PGP t+ 5? X R+++ tv-- b+(+++) DI+++ D++ G e++ h--- ++>+++ y+++* Weapons extension: ma- k++ F+2 X
|
|
|
|
|
Absolutely agree - I have enormous reservations about cloud-computing for a company's internal systems.
"If you don't fail at least 90 percent of the time, you're not aiming high enough."
Alan Kay.
|
|
|
|
|