The practice of removing old documentation was halted with the Windows 2000 DDK, according to the doc team thread here.
-----Original Message-----
From: xxxxx@lists.osr.com [mailto:xxxxx@lists.osr.com] On Behalf Of Joseph M. Newcomer
Sent: Friday, November 21, 2008 2:53 PM
To: Windows System Software Devs Interest List
Subject: RE: [ntdev] DDC/WinHEC
See below…
-----Original Message-----
From: xxxxx@lists.osr.com
[mailto:xxxxx@lists.osr.com] On Behalf Of Tim Roberts
Sent: Friday, November 21, 2008 2:10 PM
To: Windows System Software Devs Interest List
Subject: Re: [ntdev] DDC/WinHEC
Joseph M. Newcomer wrote:
I was not invited to come to the DDC. I found it odd that a co-author
of one of the books on Device Drivers was turned down, and a co-author
of one of the extant Windows Drivers courses, would be turned down,
but apparently I was not good enough to be selected to attend.
Are you saying you never applied, or that you applied and never heard a
response?
*****
I applied and received no response.
*****
Based on the reports I heard, it would have been a waste of my time
and money to have attended, so it actually worked to my advantage.
I disagree; I will summarize shortly.
Unfortunately, I get the same impression of WinHEC, which is not aided
by their increasingly poor choice of venues. …The quality of the
material seems to be going downhill; there are too many (> 0) plenary
keynote addresses, and no chance for someone to get any breadth
because the “tracks” are all specialized and concurrent. The loss of
the “birds-of-a-feather” sessions and NDA evenings at WinHEC decreases
the value tremendously.
The people on this list are not necessarily the target audience for
WinHEC. It’s aimed mostly at hardware managers, big OEMs, vice
presidents, the press, and other technical decision makers, not at
developers. That’s why we have the DDC.
****
Yes, but the DDC has been largely a waste of time. As someone earlier
observed, it used to be about communication; it now seems to be about
Microsoft telling us how we are going to work, and please shut up kids, we
know best.
****
As someone who is interested in drivers, I feel abandoned by an
attitude that can be characterized at best as indifference and at
worst as openly hostile to developers.
That’s nonsense. I was going to keep quiet about this thread, but I
have to speak up. Now, I understand that both Don and you are
inherently negative people, and that negativity colors your responses to
a very great degree, but I want to make sure that the other people who
read this also understand where you’re coming from.
****
Actually, I’m inherently positive. But after a while, even I get the
message that feedback is unwelcome.
****
I simply do not understand what the senior people on this list were
expecting from the DDC. When you’ve been in this business for as many
years as we have, it is extremely difficult to imagine what kind of
content could have been presented that is really “new”. We know the
tools. We’ve all heard the “best practices” speeches hundreds of
times. We know the party line. We know where we’ve been, and we pretty
much know where we’re going. I get the impression that some people
would not have been satisfied with the DDC unless the Microsoft
management team had taken each attendee out to a private lunch and said,
“guess what, we now have an automated tool that will create drivers in
10 minutes that are guaranteed to be bug-free!”
****
That would surprise me. What I want to know are important questions about
tooling, and why the tooling continues to go downhill in a number of ways.
Why we get poor documentation, documentation from which critical functions
have been removed (apparently, nobody need to know how the old DDI call
worked in the old driver, and we are magically supposed to intuit how it
worked so we can convert it to the new DDI call which has different
parameters), documentation which is inconsistent with the actual
implementation, tools that are poorly documented or undocumented, tools that
don’t work, tools that are “improved” by adding features that contribute
either zero or negative while existing long-term bugs in those same tools
are NOT being fixed, and other things rather important to those of us who
actually have to figure out what is going on.
I’m handed an old NT4 driver and asked “What do we have to do to this to
make it work under (2000, XP, Vista)?” and I can’t even figure out what it
does because the calls it uses have not only been deprecated but removed
from the documentation! This is why I keep a stack of DDK disks around, so
I can install an old DDK just to read the documentation. But why isn’t the
documentation available in the release DDK?
Why is the truth about PnP and Power states not documented? Why are we told
we don’t need to know it because “WDK solves everything”? Has it occurred
to anyone that companies, especially small companies, do not have the
resources to rewrite complex drivers just because it “feels good”? The fact
that the last time I looked at the DKK, not a single driver was written in
KMDF, is an example of Real World Drivers. Yet there is no support.
Where is the promised KMDF source?
Why can’t I use an existing server to run tests? I don’t want excuses; I
want a DETAILED TECHNICAL JUSTIFICATION, not something that turns out to be
“we felt like doing it that way”.
How about a debugger that actually works and is usable? Watch a new user
try to figure out why the dialog box indicating an error pops up UNDER the
command window and you will understand. Try reading code and output when it
is tiled vertically.
So how is it I’m supposed to remain optimistic and get warm, fuzzy feelings
when the simplest tools aren’t working and the production of usable
documentation is considered a serious inconvenience to Microsoft?
*****
There were many sessions at the DDC where the hardware development teams
presented real information about how their tools were created, what
pitfalls they encountered, what steps they used to ensure quality, and
what reasoning led to certain trade-offs. That’s top-notch information
from people who know what they are doing. Did they agree to satisfy
every attendee, or release full source code, or include every weird
feature request? No, of course not. Does that make the conference less
valuable? No, of course not.
When you’ve been writing storage drivers for 15 years, it is entirely
unrealistic to expect that you can attend a storage session at a DDC and
receive 90 minutes jam-packed with brand-new and exciting information.
Of COURSE most of it is going to be review. How could it not be?
There’s just not that much new information. The best you can expect is
to learn a few good tidbits here and there, to present your key issues
to people who care, to make a few good contacts, and to commiserate with
others who are in the same boat. THAT’S what the DDC provided, and it
did so excellently.
****
I have not been writing storage drivers for 15 years. But I can’t attend
the storage driver sessions because I have to attend some other session
which has even more immediate utility to me. Not at WinHEC, not at DDC.
Not that it mattered, because I was not accepted.
****
Some people are never satisfied. When you went to your first amusement
park, it was probably a magical experience for you, filled with wonder.
But after you’ve been to 6 or 7 amusement parks, the magic is gone.
Does that make the visit useless?
****
I don’t spend over $2500 (counting hotel, air fair, car rental, and
registration fee) to go to the amusement park. I need to get that much out
of the conference or it is a waste of time and money, because during that
week I not only put out $2500 in raw expenses, I lose a week of billable
time, which means it is actually vastly more expensive. It is not
cost-effective.
****
So I wonder why I am supposed to care.
I’m not sure who asked you to care.
****
Ideally, Microsoft thinks I should care. I don’t care if you ask me to
care.
****
–
Tim Roberts, xxxxx@probo.com
Providenza & Boekelheide, Inc.
NTDEV is sponsored by OSR
For our schedule of WDF, WDM, debugging and other seminars visit:
http://www.osr.com/seminars
To unsubscribe, visit the List Server section of OSR Online at
http://www.osronline.com/page.cfm?name=ListServer
–
This message has been scanned for viruses and
dangerous content by MailScanner, and is
believed to be clean.
NTDEV is sponsored by OSR
For our schedule of WDF, WDM, debugging and other seminars visit:
http://www.osr.com/seminars
To unsubscribe, visit the List Server section of OSR Online at http://www.osronline.com/page.cfm?name=ListServer