A
Andrew Thompson
Short, Self Contained, Correct (Compilable), Example
A lot of people are now paraphrasing SSCCE*
to start with 'simple' - I never intended that, and
do not agree with the word.
An SSCCE does *not* need to be 'simple',
just 'short'.
To someone who is preparing a code sample,
the word 'simple' might trip them up.
1) "If it were *simple*, why the heck would
I need to be asking questions about it? Do
you think I am an idiot?!"
2) Also, some very *complicated* problems
can be expressed in a short piece of code.
And that code is still useful in expressing the
problem, and getting help with solving it.
The word 'simple' does appear in one sentence
of the SSCCE document, and I regret that now.
It is not *ever* used in reference to the code
example itself.
* <http://www.physci.org/codes/sscce.html>
Note: this message has been cross-posted
to comp.lang.java.programmer and c.l.j.help,
with follow-ups set to c.l.j.p. only. Please feel
free to (re)set the follow-ups as seem most
logical to you.
Andrew T.
A lot of people are now paraphrasing SSCCE*
to start with 'simple' - I never intended that, and
do not agree with the word.
An SSCCE does *not* need to be 'simple',
just 'short'.
To someone who is preparing a code sample,
the word 'simple' might trip them up.
1) "If it were *simple*, why the heck would
I need to be asking questions about it? Do
you think I am an idiot?!"
2) Also, some very *complicated* problems
can be expressed in a short piece of code.
And that code is still useful in expressing the
problem, and getting help with solving it.
The word 'simple' does appear in one sentence
of the SSCCE document, and I regret that now.
It is not *ever* used in reference to the code
example itself.
* <http://www.physci.org/codes/sscce.html>
Note: this message has been cross-posted
to comp.lang.java.programmer and c.l.j.help,
with follow-ups set to c.l.j.p. only. Please feel
free to (re)set the follow-ups as seem most
logical to you.
Andrew T.