Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
02-loop example should not suggest naive evaluation of polynomials #378
According to the main website, Software Carpentry's goal is to teach basic lab skills "for research computing."
For this reason, I would remove or replace the example: "Computing the Value of a Polynomial" as it suggests a naive method of evaluating polynomials that is inefficient in general and particularly unsuited for floating point numbers due to its lack of numerical stability and accuracy - but in the context of this lesson, floating point numbers are otherwise frequently used. A novice (and SWC is targeting novices) may conclude that this is an actual usable method.
Even though the point of the exercise appears to be to practice Python's
I'm cool with adding a warning, though I would prefer one kindly worded rather than strongly worded (i.e., point the reader to better alternatives rather than telling them that this option is a bad one).
I'd be okay with removing the example if another example using
In the past people have used weblinks if there reference is online. Markdown has a format tag for that. Paper references, I'm not sure. Maybe a footnote?…
On Thu, May 18, 2017 at 7:38 AM, godmar ***@***.***> wrote: What is the recommended format for including references to other sources? — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub <#378 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AIeMuizR_ML30r4qnqjxlLsdb9-7vcfDks5r7Du5gaJpZM4Nc6k0> .
-- - - - - - - - - - - - - - - - - - - - - - Nathan Moore Mississippi River and 44th Parallel - - - - - - - - - - - - - - - - - - - - -