By my estimate, greater than 90% of the online doco code does not work
without additional coding effort. Fully working solutions are
invaluable for the student. A guru's work measured in minutes can take
a newb ages to duplicate. Imagine the improved teaching efficiency of
being able to direct someone to a working solution! Gurus would not
have to teach the same lesson repeatedly and their work would be more
persistent.
A picture is worth 1,000 words and a working solution that teaches is
worth a million!
How can this need for more fully working solutions be met?
The help provided within this group is amazing. The brain power in
here is immense. The knowledge transfer efficiency is lacking because
there are an infinite number of ways for a newb to falter when
starting from blocks of code that are not fully functional.
The only explanation to this dilemma that I can fathom is the problem
of malicious code being included in solutions. Oh how the power of the
evil wins all to often!
7  1940 
"Tom" wrote:
By my estimate, greater than 90% of the online doco code does not work
without additional coding effort. Fully working solutions are
invaluable for the student.
I would say that 99% of the online docs code does not work without addtional
coding effort to build a product. Keep in mind though, that is not the
purpose for the most part, of these types of docs. The docs are to show
examples of classes and methods, and how they are to be used. Its similar to
showing someone how to use a hammer and a nail, but not giving them details
to build a house versus a table.
I certainly empathize with your frustration.
However, having first hand experience as a teacher, I can categorically
state that most students will, when presented with a fully-working example,
will tend to copy-and-paste the example without bothering to dissect the
example and understand what the code is actually 'doing'.
Certainly some, generally those who genuinely want to learn, do make the
effort to understand the code before attempting to use it.
It's a matter of finding the happy-medium, and the concept of you can't make
everyone happy all of the time comes into play.
Generally the purpose of an example is to point you in the right direction
rather than to hand you the answer on a plate. Unfortunately there are a lot
of examples that do neither.
"Tom" <Th********@ear thlink.netwrote in message
news:9i******** *************** *********@4ax.c om...
By my estimate, greater than 90% of the online doco code does not work
without additional coding effort. Fully working solutions are
invaluable for the student. A guru's work measured in minutes can take
a newb ages to duplicate. Imagine the improved teaching efficiency of
being able to direct someone to a working solution! Gurus would not
have to teach the same lesson repeatedly and their work would be more
persistent.
A picture is worth 1,000 words and a working solution that teaches is
worth a million!
How can this need for more fully working solutions be met?
The help provided within this group is amazing. The brain power in
here is immense. The knowledge transfer efficiency is lacking because
there are an infinite number of ways for a newb to falter when
starting from blocks of code that are not fully functional.
The only explanation to this dilemma that I can fathom is the problem
of malicious code being included in solutions. Oh how the power of the
evil wins all to often!
codeproject.com is your friend
"Stephany Young" <noone@localhos twrote in message
news:OE******** ******@TK2MSFTN GP04.phx.gbl...
>I certainly empathize with your frustration.
However, having first hand experience as a teacher, I can categorically
state that most students will, when presented with a fully-working
example, will tend to copy-and-paste the example without bothering to
dissect the example and understand what the code is actually 'doing'.
Certainly some, generally those who genuinely want to learn, do make the
effort to understand the code before attempting to use it.
It's a matter of finding the happy-medium, and the concept of you can't
make everyone happy all of the time comes into play.
Generally the purpose of an example is to point you in the right direction
rather than to hand you the answer on a plate. Unfortunately there are a
lot of examples that do neither.
"Tom" <Th********@ear thlink.netwrote in message
news:9i******** *************** *********@4ax.c om...
>By my estimate, greater than 90% of the online doco code does not work
without additional coding effort. Fully working solutions are
invaluable for the student. A guru's work measured in minutes can take
a newb ages to duplicate. Imagine the improved teaching efficiency of
being able to direct someone to a working solution! Gurus would not
have to teach the same lesson repeatedly and their work would be more
persistent.
A picture is worth 1,000 words and a working solution that teaches is
worth a million!
How can this need for more fully working solutions be met?
The help provided within this group is amazing. The brain power in
here is immense. The knowledge transfer efficiency is lacking because
there are an infinite number of ways for a newb to falter when
starting from blocks of code that are not fully functional.
The only explanation to this dilemma that I can fathom is the problem
of malicious code being included in solutions. Oh how the power of the
evil wins all to often!
Bob >Thanks for the codeproject.com suggestion !!
I looked it over briefly and its a definite winner. I'll dig it plenty
for sure. :)
Some additional "Fully Working Examples" thoughts >>
For brevity and not getting lost in the forrest ... partial coding
snips do have purpose. A LOT of purpose. But do they really work? When
I try to implement them I get hours of frustration and very often NO
success. How discouraging!!
I suggest that the MS doco should snip all they want but ALWAYS give a
link to the complete and fully functional program than contains the
code. The smaller the better ... but provide a stable starting point
for us struggling to learn.
In the past 72 hours I've been struggling with two clips dealing with
binding and DataGridView. With help from Marc I managed to get
BindingList to work ... but IBindingList and DataTable are causing me
headaches. Heck, without Marc's help I'd still be stuck trying to get
List to work. Or maybe I'd have gone back and tried some more on
ArrayList? My point is this binding stuff is darn tricky and my texts
don't cover it very well. Seems the focus is on data base usage and
XML I/O. That's good stuff for sure. But there are needs for locally
generated data binding without the XML layer. IBindingList doco makes
it sound like the cat's meow for DataGridView ... but just give it a
try on a non well established database data format. If you have no
problems ... I salute you!! Even if you have database usage needs and
access to a database for learning purposes ... the examples in the
doco are incomplete. Thus you really know your stuff, or you are in
for some pain. :(
If you are coaching a football team ... don't you provide the play
book to the team members? Or do you tell them you have some good plays
and here's some of the aspects but I can't be bothered to show you all
the details? HA!! Give me a working starting point and let me learn by
experimenting. Please!!! No example program is going to meet my exact
needs ... so the fear of a student cutting and pasting without
studying the code seems a bit like an excuse for the way things are.
I'm not asking for a play book with every play ever conceived ... just
a reasonably solid set would be a tremendous improvement.
Here's a goal >90% of the snips linked to fully working solutions.
After all, somebody did test them? Right? Come on Coach MS ... don't
call two times outs on us again, everyone makes mistakes but we little
guys that can't afford enterprise level applications need better
support.
Whew, I vented ... but I don't feel the least bit better. I know my
struggles will continue and that many others are in the same boat.
Why post this noise of mine here you might ask? I feel it has just as
likely a chance to be heard here as anywhere. The voice of one is
weak. Take a poll on years of programming experience vs the doco
examples usefulness. The focus needs to shift a bit towards the entry
level. Maybe someday I won't be a newb? I'd still appreciate solid
working solutions for examples!
-- Tom
BobF <rN***********@ charter.netwrot e:
codeproject.com is your friend
Well, partly. I've seen a lot of *really* dodgy examples on
CodeProject. The only sort of peer review is through comments, and
often there'll be a lot of people saying how it's exactly what is
required before you get to comments explaining how the sample is
critically flawed.
This isn't limited to CodeProject of course. For example, look at: http://dotnet.org.za/deon/pages/2998.aspx
I happened to see this (can't remember why) and people had been pretty
confident in it, not spotting that the salt was being used in a
completely broken way.
Examples in books *tend* to be better because they have extensive peer
review before being published; full, active open source applications
which have been around for a while tend to be reasonable as well,
although it's far from always the case.
--
Jon Skeet - <sk***@pobox.co m> http://www.pobox.com/~skeet Blog: http://www.msmvps.com/jon.skeet
World class .NET training in the UK: http://iterativetraining.co.uk
Tom wrote:
By my estimate, greater than 90% of the online doco code does not work
without additional coding effort. Fully working solutions are
invaluable for the student.
No. The purpose of example code is not to build and run the
code. The purpose of example code is to read the code. So
whether there are a Main to call the code is irrelevant.
Good examples are short and focus on the essential.
Arne
On Thu, 06 Dec 2007 21:43:43 -0500, Arne Vajhřj <ar**@vajhoej.d k>
wrote:
>Tom wrote:
>By my estimate, greater than 90% of the online doco code does not work
without additional coding effort. Fully working solutions are
invaluable for the student.
No. The purpose of example code is not to build and run the
code. The purpose of example code is to read the code. So
whether there are a Main to call the code is irrelevant.
Good examples are short and focus on the essential.
I agree.The walkthroughs are excellent ways to learn and better
understand the topics.
regards
A.G. This thread has been closed and replies have been disabled. Please start a new discussion. Similar topics | |
by: Hans Deragon |
last post by:
Greetings.
Total newbie to Glade here. I created an interface using glade-2
and I want to use it with my python program. Following is what I
wrote (test prg):
-------------------------
#!/usr/bin/python
|
by: Lewis |
last post by:
I have "My Documents" redirected to a network share but when I go to open a
project it says that the share is not fully trusted.
I found this info:
> The simplest (least work) in this situation is to change the machine policy (those 3 options are known as policy levels). Under the Intranet zone groop, add a new code group with a Membership condition of type Site and value of the machine you want to trust. Then set the Permission Set to be...
|
by: John Dann |
last post by:
I have a listview control on a simple vb.net form that's populated
programmatically. It is set to scrollable and a scroll bar duly
appears. However the scroll bar doesn't allow the bottom rows of the
list to be seen.
For example, if I have 31 rows in the list with the control set to a
height that shows maybe 20 rows then the scroll bar allows me to get
down to eg row 28 as the bottom row, but not row 31. Yet if I drag the
bottom of the...
|
by: Xah Lee |
last post by:
The Concepts and Confusions of Pre-fix, In-fix, Post-fix and Fully
Functional Notations
Xah Lee, 2006-03-15
Let me summarize: The LISP notation, is a functional notation, and is
not a so-called pre-fix notation or algebraic notation.
Algebraic notations have the concept of operators, meaning, symbols
placed around arguments. In algebraic in-fix notation, different
|
by: Syam |
last post by:
Fully answered interview questions in c and c++ from
http://www.faiqs.com
| | |
by: Toby Inkster |
last post by:
Does anyone have any idea why this effect using script.aculo.us is working
in Opera, but not Firefox?
http://examples.tobyinkster.co.uk/Balloons2/Balloon%20tooltip.html
(I've not had the courage to even try it in IE yet!)
Any ideas for a fix?
Thanks
|
by: Xah Lee |
last post by:
The Concepts and Confusions of Prefix, Infix, Postfix and Fully
Functional Notations
Xah Lee, 2006-03-15
In LISP languages, they use a notation like “(+ 1 2)” to mean “1+2”.
Likewise, they write “(if test this that)” to mean “if (test) {this}
else {that}”. LISP codes are all of the form “(a b c ...)”, where the
|
by: Bill Reid |
last post by:
This is how I handle a check that the last character of a text
file is a newline:
/* checks if newline is last character of text file */
unsigned check_text_file_newline_termination(FILE *test_file) {
int end_char;
fseek(test_file,-1L,SEEK_END);
end_char=getc(test_file);
|
by: Duncan Booth |
last post by:
candide <candide@free.invalidwrote:
General comments about the page:
Section 2: Poor demonstration of 'global'. The declaration of 'a' as global
is unnecessary and misleading.
Section 4: "Maths: Requires import math"
The supplied examples won't work if you just "import math", they need a
|
by: Hystou |
last post by:
Most computers default to English, but sometimes we require a different language, especially when relocating. Forgot to request a specific language before your computer shipped? No problem! You can effortlessly switch the default language on Windows 10 without reinstalling. I'll walk you through it.
First, let's disable language synchronization. With a Microsoft account, language settings sync across devices. To prevent any complications,...
|
by: Hystou |
last post by:
Overview:
Windows 11 and 10 have less user interface control over operating system update behaviour than previous versions of Windows. In Windows 11 and 10, there is no way to turn off the Windows Update option using the Control Panel or Settings app; it automatically checks for updates and installs any it finds, whether you like it or not. For most users, this new feature is actually very convenient. If you want to control the update process,...
| | |
by: agi2029 |
last post by:
Let's talk about the concept of autonomous AI software engineers and no-code agents. These AIs are designed to manage the entire lifecycle of a software development project—planning, coding, testing, and deployment—without human intervention. Imagine an AI that can take a project description, break it down, write the code, debug it, and then launch it, all on its own....
Now, this would greatly impact the work of software developers. The idea...
|
by: isladogs |
last post by:
The next Access Europe User Group meeting will be on Wednesday 1 May 2024 starting at 18:00 UK time (6PM UTC+1) and finishing by 19:30 (7.30PM).
In this session, we are pleased to welcome a new presenter, Adolph Dupré who will be discussing some powerful techniques for using class modules.
He will explain when you may want to use classes instead of User Defined Types (UDT). For example, to manage the data in unbound forms.
Adolph will...
|
by: conductexam |
last post by:
I have .net C# application in which I am extracting data from word file and save it in database particularly. To store word all data as it is I am converting the whole word file firstly in HTML and then checking html paragraph one by one.
At the time of converting from word file to html my equations which are in the word document file was convert into image.
Globals.ThisAddIn.Application.ActiveDocument.Select();...
|
by: TSSRALBI |
last post by:
Hello
I'm a network technician in training and I need your help.
I am currently learning how to create and manage the different types of VPNs and I have a question about LAN-to-LAN VPNs.
The last exercise I practiced was to create a LAN-to-LAN VPN between two Pfsense firewalls, by using IPSEC protocols.
I succeeded, with both firewalls in the same network. But I'm wondering if it's possible to do the same thing, with 2 Pfsense firewalls...
|
by: adsilva |
last post by:
A Windows Forms form does not have the event Unload, like VB6. What one acts like?
|
by: 6302768590 |
last post by:
Hai team
i want code for transfer the data from one system to another through IP address by using C# our system has to for every 5mins then we have to update the data what the data is updated we have to send another system
| | |
by: bsmnconsultancy |
last post by:
In today's digital era, a well-designed website is crucial for businesses looking to succeed. Whether you're a small business owner or a large corporation in Toronto, having a strong online presence can significantly impact your brand's success. BSMN Consultancy, a leader in Website Development in Toronto offers valuable insights into creating effective websites that not only look great but also perform exceptionally well. In this comprehensive...
| |
