Create R.html - Githubissues

DevasenaInupakutika commented 9 years ago

the-r-series R Introductory motivational slides prepared with @danlwarren. Need to include attached image for reference book's cover page as stated in slides.

jdblischak commented 9 years ago

Thanks @DevasenaInupakutika!

It appears that there was also parallel development on R motivational slides during the recent sprint. @sritchie73 contributed PR #614. It's great that there is so much interest motivating the use of R. Perhaps the two efforts can be combined?

DevasenaInupakutika commented 9 years ago

@jdblischak Sure! Sounds good. Do you want me to combine both based on what is missing in our slides and @sritchie73 slides?

gvwilson commented 9 years ago

Yes please, and thank you.

jdblischak commented 9 years ago

@DevasenaInupakutika, I'd recommend getting @sritchie73's opinion before starting to combine the two.

sritchie73 commented 9 years ago

Your slides look great, I'm happy for you to merge the content. I'm at a conference for the next few days so I won't be much help here.

On 30 July 2014 23:36, John Blischak notifications@github.com wrote:

@DevasenaInupakutika https://github.com/DevasenaInupakutika, I'd recommend getting @sritchie73 https://github.com/sritchie73's opinion before starting to combine the two.

— Reply to this email directly or view it on GitHub https://github.com/swcarpentry/bc/pull/628#issuecomment-50614655.

DevasenaInupakutika commented 9 years ago

Thanks @sritchie73 ! I'll do that by this weekend then.

DevasenaInupakutika commented 9 years ago

Hello everyone (@gvwilson,@sritchie73, @jdblischak,@danlwarren),

Please find updated R.html motivational slides which includes information from @sritchie73 R slides and our slides attached herewith.

Any comments, suggestions or feedback would be much appreciated as always.

Cheers, Devasena

jdblischak commented 9 years ago

Thanks @DevasenaInupakutika. However I cannot view the slides because there is + in front of each line. You can remove them with the following sed command:

sed s/"[ ]*+"// slides/R.html > slides/Rnew.html
mv slides/Rnew.html slides/R.html

This gets rid of the + on the first line and the + with a preceding space on each subsequent line.

jdblischak commented 9 years ago

Some thoughts:

Be consistent with the capitalization of the titles. Sometimes all the words are capitalized and sometimes only the first word is.
The title of the slide "What It Is?" should be either "What Is It?" or "What It Is".
The slide mentioned in my last point has seven points. The last few points can get cut off depending on the size of the screen. Maybe you could make the points more concise or split the content into two separate slides.
I think the "Learn More" slide should go at the end of the presentation.
In the syllabus, I don't think it is necessary to put R in front of most of the sections.
There are lots of books on R. Is there a reason we are endorsing one particular author?

DevasenaInupakutika commented 9 years ago

Thanks @jdblischak for the feedback! I'll incorporate these changes and update here today EOD.

DevasenaInupakutika commented 9 years ago

Updated R.html as per comments and feedback.

@jdblischak Regarding reference book, there's no specific reason of including that particular author. Do you think, it would be good to include some of the other references too along with this and remove book cover image then?

As usual suggestions and feedback would be much appreciated based on the latest R.html slides.

jdblischak commented 9 years ago

Thanks, @DevasenaInupakutika. The slides look good.

As for the book image, I do not think it is necessary. If you want a final image, why not use the R logo instead? The sales pitch of these slides is "Use R for your scientific research". Without very good justification, I don't think the sales pitch should include "Buy this book". If you want to include a few links to good R resources, e.g. that book and others, why not add them to the Learn More page?

DevasenaInupakutika commented 9 years ago

Thanks @jdblischak ! Using R logo for image sounds good and I removed "buy book" section. But before submitting the patch again, just wanted to confirm that "sales pitch" is "title of slides"?

jdblischak commented 9 years ago

Ah, I apologize for using that colloquial expression. A sales pitch is when one gives a presentation to persuade someone to buy something. In this context, I used it as shorthand for "the persuasive message in your presentation". Thus the message you are trying to convey to the audience with this short presentation is that using R for scientific research is a good idea. I felt that having the image of that book at the end additionally conveyed the message that Software Carpentry endorsed that particular book. In short, you do not need to modify the titles of your slides. Does that make sense? I hope I was not overly pedantic.

DevasenaInupakutika commented 9 years ago

Oh...Ok. Got it now. Thanks @jdblischak ! Actually, my fault. Couldn't comprehend properly.

DevasenaInupakutika commented 9 years ago

@jdblischak and all How about while including few books in "Learn More" section, if we mention "There are many online tutorials available for R including SWC's R material" and then a link to SWC's bc repository? Can we mention this in slides?

jdblischak commented 9 years ago

Oh...Ok. Got it now. Thanks @jdblischak ! Actually, my fault. Couldn't comprehend properly.

Definitely not your fault. I was unclear.

@jdblischak and all How about while including few books in "Learn More" section, if we mention "There are many online tutorials available for R including SWC's R material" and then a link to SWC's bc repository?

Yes, I think it makes sense to have links to some other sources in the Learn More section.

DevasenaInupakutika commented 9 years ago

Updated R motivational slides with few more tutorial links. Could you all please have a look at it again and let me know in case of any further amendments.

DevasenaInupakutika commented 9 years ago

Included updates from @danlwarren.

jdblischak commented 9 years ago

It seems that the slide "Why R and not another language or platform" contains the long form notes that explain the bullet points on the following slide "Packages".

DevasenaInupakutika commented 9 years ago

Apologies for late reply and action. Made changes and committed again.

jdblischak commented 9 years ago

Alright, let's have some votes on this. @sritchie73 , @danlwarren, @gvwilson, I'll merge this in once I hear from at least one of you.

jdblischak commented 9 years ago

@DevasenaInupakutika or @sritchie73, would one of you be able to make the last few changes needed before this PR can be merged? Please let me know if you need help locally rendering the file to view the changes.

DevasenaInupakutika commented 9 years ago

@jdblischak Sure, I would do that and reply back here surely by this Friday.

swcarpentry / DEPRECATED-bc

Create R.html #628