[Discuss] Lesson - Markdown/Writing Style Guide - Request for Comments (RFC)

[Raniere Silva]

Hi all,

We have been doing an amazing job to keep some Markdown/writing style across 
our lessons but with the increase of contributors I believe that we are 
reaching the point where we need to document what
we have being doing in terms of Markdown/writing style. Last year, we agreed on 
some writing style for keyboard keys, see 
https://github.com/swcarpentry/lesson-example/pull/131. Early this year, we
agreed to avoid using "click here" for links, see 
https://github.com/swcarpentry/lesson-example/issues/175. I want to discuss the 
use of italic, boldface and monospaced font, see https://github.com/sw
carpentry/shell-novice/pull/778. This have been discussed before, for example, 
last year we had https://github.com/swcarpentry/shell-novice/pull/522 and this 
year we had https://github.com/swcarpentry
/shell-novice/pull/778. If you have strong opinion about it, please leave a 
comment at https://github.com/swcarpentry/lesson-example/pull/201 or reply to 
this email.

Thanks.

Raniere___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Should we use reticulate?

[Raniere Silva]

> Actually, you can cleanly commit changes to Jupyter notebooks havebeautiful 
> diffs using the nbstripout python package.

I didn't know the package. Thanks for it.

But we I'm talking about doing things directly on GitHub web interface. So far, 
any diff on GitHub pull request view will be something like 
https://github.com/omsai/intein_finder/commit/83536bacebcc61
19ec08cb09e986c6966790786e which is hard to read given the JSON structure.

> Can you elaborate a little on #3 about nesting cells?

> ## Challenge: Can you do it?
>
> What is the output of this command?
>
> ```
> paste("This", "new", "template", "looks", "good")
> ```
>
> > ## Solution
> >
> > ```
> > paste("This", "new", "template", "looks", "good")
> > ```
> {: .solution}
{: .challenge}

is how we write challenges at the moment. Please note that we have some code 
inside the blockquote and we want that code chunk to be processed by reticulate 
(or Jupyter, to reply your question). In R
Markdown, the previous example is valid and all the code blocks can be executed 
and will received their output in the final HTML. Unfortunately, is not 
possible to have a code cell inside a Markdown
cell in Jupyter, something like

{
  "cell_type": "markdown",
  "metadata": {},
  "source": [
"> ## Challenge: Can you do it?\n",
">\n",
"> What is the output of this command?",
{
  "cell_type": "code",
  "execution_count": null,
  "metadata": {},
  "outputs": [],
  "source": [
  "paste("This", "new", "template", "looks", "good")\n",
  ]
}
  ]
}


but this isn't a valid cell because you have a cell inside another one.

Raniere___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Should we use reticulate?

[Raniere Silva]

> I'm fairly recent to this list, so I've probably missed it, but why not  
> Jupyter notebooks?

1. You can't edit Jupyter Notebooks on GitHub.2. You can't diff Jupyter 
Notebooks on GitHub.3. You can't have nest cells in Jupyter Notebooks (we need 
this for exercises).
I know that I mentioned GitHub twice but this is because this of discussions 
with other people that want to lower the barrier to contribute to the lessons 
and one way was to do things in the cloud
instead of locally.
Raniere___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Should we use reticulate?

[Raniere Silva]

Hi Tim,
> a slightly left field suggestion: maybe use something like thebelab orjuniper 
> to make the code examples executable (and automatically generateoutput)?
> Having it editable and runnable from the browser is an anti-feature for 
> youbut maybe the same snippet of JS can be used to just do the 
> automaticexecution with editing disabled.

I didn't completely understand what you are suggesting. I think that editable 
and runnable from the browser is a nice features for package/library 
documentation due different reasons. For me, it
doesn't fit the audience of The Carpentries that, on average, is novice 
"research software engineers" who should get confidence typing their code 
instead of click in the browser and see something
running. And we know some people print the lesson so provide a printable 
version based on automatically generate output done in the web browser would be 
more challenge.
Cheers,Raniere___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] GitHub Issue template improvements

[Raniere Silva]

GitHub announced yesterday some improvements on issue template that might be 
useful for Instructor Training, see 
https://blog.github.com/2018-05-02-issue-template-improvements/.

Raniere___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] More questions about workshop class size...

[Raniere Silva]

> I didn't hear a lot of strong opinions about a lower limit.  What arepeople's 
> thoughts there?  Would you want to teach a workshop for less than10 people? 
> Less than 5 people?

For < 10 people it would only make sense for me if those learners belong to a 
group that I would strong collaborate with in the near future because in the 
long run of the collaboration the time that I
invested in the workshop would pay itself by not having to exchange emails.
> What if it wasn't one you were involved in planning at your home institution, 
> but it was one you traveled to a new site to teach?

Smaller group would not be a problem. Larger group without advance notice would 
make me upset.
> How would you feel traveling to an unfamiliar site to teach a very large or 
> very small group?

The local organisers would make a big difference on how I feel. Small group 
would be OK. For large group, I would only feel confident of do a good work if 
I knew that we have enough helpers.
> What would you want to know in advance?

I think that the pre-workshop survey has most of the information. Details about 
wifi connectivity would be great.
Raniere___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Class size for workshops

[Raniere Silva]

Hi all,

my experience as organiser and instructor is that the room used for teaching is 
more important than the class size (given the same ratio of students and 
helpers). If you have a room where helpers can
walk easily and that instructors need to not direct face the projector this 
will impact the learners experience.

> Is there a lower limit to this, where it doesn't seem big enough to 
> worthwhile in those ways?

10 or less learners will probably make hard to provide a engaging, hands on, 
and interactive workshop.

> And is there an upper limit, where it's too big to be worthwhile in those 
> ways?

I would try to keep the class size up to 30 learners and accept some extra in a 
case-by-case scenario. I would not have a class bigger than 40 in any scenario.

Raniere
> ___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] One weeks until the Collaborations Workshop 2018 (CW18) kicks off. Register Now!

[Raniere Silva]

Hi all,

Sorry to bug you about this again. I promise this is the last time.

If you are based in Europe, you should consider attend Collaborations Workshop 
2018 (CW18). At Collaborations Workshop 2018, you’ll find an amazing group 
composed of researchers, developers,
innovators, managers, funders, publishers, leaders and educators. All of them 
play an important role in shaping the culture of our society and without them 
we would probably live in a very different
world. Throughout the event, we will facilitate discussions about culture 
change, productivity, and sustainability within the this group.

We have Kirstie Whitaker (Alan Turing Institute) and John Hammersley (Overleaf) 
as keynotes on Monday 26 March. They will talk about two of the themes of this 
Collaborations Workshop: culture change
and productivity. Other talks and discussions around the themes and software 
sustainability will be part of the programme that feature Adrian-Tudor Panescu 
(figshare), Daniel S. Katz (University of
Illinois Urbana-Champaign), Naomi Penfold (eLife) , Alys Brett (Culham Centre 
for Fusion Energy) and Carina Haupt (German Aerospace Center).

Attendees will also have access to nine mini-workshops, a hackday with a chance 
to win prizes and some social activities in Cardiff. If you haven’t register 
for Collaborations Workshop 2018, what are
you waiting for? We only have a few tickets left, so don't miss your chance to 
attend this event that promises to be revolutionary.

The clock is ticking away and this is your last chance to register on the CW18 
Eventbrite page.


-- 
Raniere Silva
Community Officer, Software Sustainability Institute
+441612753301
http://www.software.ac.uk/ id="-x-evo-selection-start-marker">
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] introduction to SWC

[Raniere Silva]

Hi Rayna,

Katy did a voice over in 2015 introducing Software Carpentry. 
https://github.com/swcarpentry/slideshows

Cheers,
Raniere
> ___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] conda and Git BASH

[Raniere Silva]

Hi Damien,

I don't remember the details of the Git Bash PATH but you probably need to 
change it to include Conda.

Cheers,
Raniere
> ___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Git lesson through RStudio?

[Raniere Silva]

Hi Abhijit,

The Software Carpentry "bylaws" only mentioned that you must teach a version 
control system. It could be Git, Mercurial, SVN or another one.

In terms of learners experience during the lesson, I was helping on a web 
development workshop and I noticed that different users had different graphical 
user interfaces of GitHub Desktop client which
made very hard to help learners. I don't use R Studio's Git interface so I 
don't know how often it change that will impact the workshop, for example, if 
one of the learners installed R Studio 6 months
ago and didn't updated it for the workshop how much the graphical user 
interface will be different? Another point, is how the conflict resolution 
works in R Studio?

Cheers,
Raniere
> ___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Default git/python lesson order

[Raniere Silva]

Software Carpentry doesn't enforce a order for the lesson be taught. You must 
teach Bash, Git and best practices in one language (normally Python or R). The 
order can be adjusted based on the
audience. I taught in both scenarios that you described and I can't say that I 
noticed a big difference for the learners.

Cheers,
Raniere___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Default git/python lesson order

[Raniere Silva]

Hi Iñigo,

> We noticed that, since our last SC workshop a few months ago, lesson
> order has changed in the workshop webpage template from
> 
> (1)  bash / git + python(I) / python(II)
> 
> to
> 
> (2)  bash / python(I) + git /python(II)

https://swcarpentry.github.io/workshop-template/ doesn't show the schedule 
because it is different for Software Carpentry, Data Carpentry and Library 
Carpentry. When you change the YAML header at
index.html you will get the schedule from 
https://github.com/swcarpentry/workshop-template/blob/gh-pages/_includes/sc/schedule.html
 or https://github.com/swcarpentry/workshop-template/blob/gh-pages/_i
ncludes/dc/schedule.html or 
https://github.com/swcarpentry/workshop-template/blob/gh-pages/_includes/lc/schedule.html.
 The Software Carpentry schedule still shows

- Morning of 1st day: bash
- Afternoon of 1st day: Python
- Morning of 2nd day: Git
- Afternoon of 2nd day: SQL

Please send provide us with a link so we can track the change.

Raniere___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Collaborations Workshop 2018: keynote speakers, sponsors and activities

[Raniere Silva]

Hi,

If you are based in the UK or not, you should consider attending Collaborations 
Workshop 2018. More details below.

All members of the research software community are invited to discuss culture 
change, productivity and sustainability at the Software Sustainability 
Institute Collaborations Workshop 2018 (CW18) on
26th-28th March, in Cardiff.

We are pleased to have Kirstie Whitaker, a Research Fellow at the Alan Turing 
Institute with a long journey as an open science advocate, as one of our 
keynote speakers. In addition to learn from
Kirstie, attendees will have the opportunity to share experience during 
discussion session, collaborative ideas and mini-workshops. On the 28th, we 
will have a hackday with some prizes for the winner
project.

There is still time to propose a mini-workshop and share something from your 
researcher utility belt or discuss approaches to boost culture change or 
productivity. For those that need a bit of
inspiration, proposals on the lines of "Using GitLab to project manage home 
renovation priorities" or "100% Emacs: How To Do Everything In Emacs" will be 
considered.

When registering for Collaborations Workshop 2018 on our Eventbrite page, you 
will find a field related to mini-workshops & demos where you can describe your 
ideas for the session. We will be
contacting proposers on Friday 2nd March.

For more information, please visit https://www.software.ac.uk/cw18. Tickets for 
the event are available on Eventbrite.

We look forward to seeing you there!

Please feel free to forward this email to any relevant contacts.

Best wishes,

-- 
Raniere Silva
Community Officer, Software Sustainability Institute
+441612753301
http://www.software.ac.uk/
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] GitHub's multiple issue and pull request templates

[Raniere Silva]

Good news from GitHub team: 
https://github.com/blog/2495-multiple-issue-and-pull-request-templates.

I created https://github.com/swcarpentry/styles/issues/201 to keep track of any 
template that our community want to have.

At the moment, we are only using the templates to remind future instructors 
about their contribution as part of instructor training. I will liaison with 
Erin to see if we can improve this template.

Enjoy your weekend.

Raniere___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Eventbrite waitlist

[Raniere Silva]

> Thanks everyone - does anyone know of an automated alternative to Eventbrite? 
> This seems like a somewhat critical feature…

https://ti.to I used it as a attendee to many conferences last year (e.g. PyCon 
UK, EuroPython, MozFest). You might want to try it. I don't know how their 
waitlist works.
Raniere___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Eventbrite waitlist

[Raniere Silva]

Hi Pat,
> We were wondering whether anyone else is noticing a weird (to us) behavior 
> using Eventbrite with waitlists. Say we have a workshop set up and we create 
> 30 tickets. Those sell out and we then get a
> waitlist. Feeling ambitious, we create an additional 15 tickets. 
> Alternatively, one of the people that got a ticket returns their ticket. In 
> both cases, we noticed that people on the waitlist are
> not automatically contacted to take the available ticket - they have to be 
> invited manually. In the mean time, someone else could come in and take an 
> open seat even though there might be 30 people
> on the wait list. Is there a setting we’re missing or does anyone have a work 
> around?

This is the behaviour that I remember from Eventbrite. You need to release 
tickets manually. And Eventbrite doesn't enforce new tickets to go for people 
on the waitlist. I think they design it
thinking in maximise the number of tickers that are sell instead of being a 
fair system. For example, someone return their tickets with less than 24 hours. 
The first one in the waitlist could not
check the email in time for many reasons. If someone visited the website, they 
are possible buyers so sell the ticket to them will increase your revenue and 
that's what Eventbrite want.
Cheers,Raniere___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Citing Software Carpentry and Data Carpentry

[Raniere Silva]

> What’s the best way to cite Software Carpentry and Data Carpentry

Maybe not the correct one, but I would cite
Wilson G. Software Carpentry: lessons learned [version 1; referees: 3 
approved]. F1000Research 2014, 3:62 
(doi: 10.12688/f1000research.3-62.v1)
Raniere___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Git installation

[Raniere Silva]

Hi Azalee,

Thanks for the information.

I created https://github.com/swcarpentry/workshop-template/issues/454 to keep 
track of it.

If anyone has any information about this problem, please leave a comment in the 
previous link.

Raniere
> ___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] teaching programming in secondary school

[Raniere Silva]

Hi Olav,

Please have a look at https://www.codeforlife.education/. Is the best platform 
that I encounter so far because it start with block-based coding but make the 
transition to Python very smooth.

Raniere
> ___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Can you volunteer 10 minutes?

[Raniere Silva]

Hi all,

as I mentioned before, I have a lesson template release candidate in place. I 
added syntax highlight, thanks to @naught101, for the next release. I will not 
add any new feature for this release. If
you have 10 minutes to volunteer today, please have a look at the lesson 
template on GitHub Pages and open a issue here is something is broken. I will 
fix this issue and any other on my Sunday and
create the new release so that maintainers could work on the end of year 
release of the lessons.

Thanks, in advance, for all your help.

Raniere 

signature.asc
Description: This is a digitally signed message part
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] FW: Welcome to the new Firefox

[Raniere Silva]

Hi Amy,

Thanks for the issue.

A pull request to https://github.com/swcarpentry/workshop-template would be 
welcome.

Maneesha,

Sorry to copy on this email. Please redirect my request to the correct person. 
Could you contact the leader instructor of workshops in the short future that 
will teach SQL and mention this thread to
them?

Raniere
> 

signature.asc
Description: This is a digitally signed message part
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] A one day conversation for open source software sustainers - the report

[Raniere Silva]

Hi all,

I came across this report about open source software sustainability and though 
it was interest and worth sharing. A summary is available here.

Cheers,
Raniere

signature.asc
Description: This is a digitally signed message part
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Release candidate for next (v9.3.0) lesson template

[Raniere Silva]

Hi all,

We have in place a new release candidate for our lesson template. If you visit 
http://swcarpentry.github.io/lesson-example/, you will see the release 
candidate in action.

Among the changes, we have "offline" navigation, better style for keyboard keys 
and better page of figures. A full list of the changes is available at 
https://github.com/swcarpentry/styles/milestone/2
?closed=1 and 
https://github.com/swcarpentry/lesson-example/milestone/4?closed=1.

If you noticed that something is broken, please open a issue and I will fix it 
for the release (probably in one week time).

Cheers,
Raniere

signature.asc
Description: This is a digitally signed message part
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Teaching R

[Raniere Silva]

Hi François,

> We are teaching the tidyverse in the Data Carpentry R ecology lesson. We
> recently transitioned to using read_csv and write_csv instead of the
> equivalent functions that come with R. We are keeping some of the syntax
> and notation of the base R programming because even if the tidyverse is
> becoming increasingly popular, people will inherit code from lab members
> that is not using it, and knowing a few key elements of the syntax will
> help.

Would not be the case to have a call out box after the first use of read_csv 
and write_csv
instead of using read.csv at the lesson and live coding/teaching using read_csv?

Cheers,
Raniere

signature.asc
Description: This is a digitally signed message part
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Teaching R

[Raniere Silva]

After a long discussion with Anna Krystalli and some work using R reviewed by 
Mario Antonioletti, I got convinced that we should teach Tidyverse to novices 
because it solves some R issues. One example
is to use readr instead of native R read.XXX function because it fix the 
conversion of white space to dot in headers.

Data Carpentry R Ecology doesn't use Tidyverse. I don't know if they have any 
plan to migrate the lesson to Tidyverse. And I don't remember if any other 
Carpentry lesson adopts Tidyverse from the
begin specially because of the overload of teaching how to load it to novices 
which was the source of a log discussion for the Python lesson that never reach 
a agreement.

Raniere

signature.asc
Description: This is a digitally signed message part
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Software Sustainability Institute's Fellowship Programme 2018 - Applications closing soon

[Raniere Silva]

Hi all,

if you are based in the UK, this message is for you.

Applications for the Software Sustainability Institute Fellowship Programme 
2018 close on Monday, 9th October 2017 at 23:59 BST. This is a great 
opportunity to help you with Software Carpentry, Data
Carpentry or Library Carpentry workshop.

Joining the Software Sustainability Institute Fellow community means much more 
than just receiving funding to attend or organise conferences, workshops and 
other events. Some of our Fellows have said
that it is  "a great way to collaborate across disciplines", "a really 
worthwhile experience that I cannot recommend more" and "a great opportunity to 
meet friendly new people", among other positive
comments.


Read more reasons why you should apply to our fellowship programme on the 
"Highlights from the Fellowship Programme 2018 Launch Webinar" blog entry. Find 
out more details and how to apply on the
Programme page.

If you have any questions, do not hesitate to contact 
fellows-managem...@software.ac.uk. 

We are also interested on your feedback about the changes that we make on the 
application this year. Please fill this 1 minute or less feedback survey to 
help us improve future editions.

Raniere

signature.asc
Description: This is a digitally signed message part
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Software Sustainability Fellowship Programme 2018: Launch Webinar Highlights & Recording

[Raniere Silva]

For Instructors based in the UK!

The Software Sustainability Institute hosted a Launch Webinar two weeks ago. 
Prospective applicants learnt more about the Institute, the Fellowship 
Programme, application process and timeline, current
Fellows’ experiences, and the types of activities and support they can expect 
from the Institute . 

If you’d like to learn more, please read some of webinar’s highlights and watch 
the full recording.

Apply to our Fellowship Programme by Monday 9th October 2017.

What is the programme about

The Fellowship Programme run by the Software Sustainability Institute funds 
researchers in exchange for their expertise and advice. Being a Fellow also 
helps you develop skills and knowledge in the
area of software sustainability. Each Fellow is allocated £3,000 to spend over 
fifteen months. The funding is flexible to support activities that are 
beneficial to both the Fellows and the
Institute.Fellows are drawn from a wide range of areas, experience, and career 
stages (www.software.ac.uk/fellows). The Fellowship is open to UK based 
applicants.

To find out more about the programme, visit bit.ly/fellowship-programme.

-- 
Raniere Silva
Community Officer, Software Sustainability Institute
+441612753301
http://www.software.ac.uk/
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Hacktoberfest

[Raniere Silva]

Hi,

Is any of the maintainers interested to take part on Hacktoberfest? From the 
website rules, we need to

1. Apply the label ”Hacktoberfest” to issues in your GitHub project that are 
ready for new contributors to work on.

2. If you receive “spammy” pull requests, please let us know by applying the 
“invalid” label.

If you are interested, please leave a comment or thumbs up at 
https://github.com/carpentries/conversations/issues/14.

Raniere

signature.asc
Description: This is a digitally signed message part
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Diversity & Inclusion in Scientific Computing (DISC)

[Raniere Silva]

Good morning all,

NumFOCUS is organising the first Diversity & Inclusion in Scientific Computing 
(DISC) Unconference at PyData NYC 2017 between 29 November and 30 November. The 
unconference will be a invited-only event
but they are accepting application from potential attendees until 8 October. I 
know that many instructors are interested in improve inclusion among their 
community and this looks a great opportunity
to share our experience. Maybe who attend the unconference could report back 
during CarpentryCon.

Raniere Silva

signature.asc
Description: This is a digitally signed message part
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Applications to the Software Sustainability Institute's Fellowship Programme 2018 are now open

[Raniere Silva]

Hi,


Instructors based on the UK or Europe with strong collaboration with UK 
researchers may be interested in this opportunity.


The Software Sustainability Institute invites everyone involved in research 
software to apply for the Fellowship Programme 2018.
Visit the Fellowship Programme page for more information and how to submit an 
application.
We are looking for applicants at any career stage who can demonstrate a passion 
for their area, the ability to communicate ideas effectively, and a real 
interest in the role of software in research.
The Software Sustainability Institute’s Fellowship Programme will, among many 
other benefits, support you to talk about software in your research domain to a 
wider audience, network with others who
share a passion for software in research, and learn about key skills to benefit 
you and those you collaborate with. 
Launch Webinar Fellows 2018The upcoming Fellows 2018 launch webinar will take 
place on Friday 15th September from 2.00pm to 3.30pm BST.
You will be able to find out more about the programme, the application process, 
existing Fellows experiences and ask any questions. 
If you are interested in participate in the webinar please register your 
interest.
Further informationIn the meantime, if you have questions about the Programme, 
please contact Raniere Silva, Institute Community Officer at 
fellows-managem...@software.ac.uk.
Help us spread the word—Feel free to distribute this email or this flyer to 
your network, or retweet this announcement!
Kindest regards,
-- 
Raniere Silva
Community Officer, Software Sustainability Institute
+441612753301
http://www.software.ac.uk/
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Fwd: FOSTER - call for trainers to share their experiences in a book sprint

[Raniere Silva]

Hi,

members of this list could be interested to apply to participate
authoring the handbook on Open Science training mention below.

Cheers,
Raniere

 Forwarded Message 

> From: Joy Davidson 
> Subject: [rda-edu-ig] FOSTER - call for trainers to share their
> experiences in a book sprint
> Date: 2 August 2017 at 14:53:46 BST
> To: Education and Training on handling of research data IG  g...@rda-groups.org>
> Cc: "Brinken, Helene" 
> 
> Hi everyone,
>  
> I wanted to share this pre-call for potential authors to a
> collaboratively author a handbook on Open Science training written by
> trainers for trainers. The call will go out more widely via the
> FOSTER website in September but I wanted to share it with members of
> this group in advance. The dates are still be finalised but it will
> likely take place the first or second week of February in Hanover,
> Germany. If you have any questions, please contact Helen Brinken
> (cc’d). 
>  
> All the best,
> Joy
>  
>  
> Call to Open Science trainers – share your experiences and help to
> write a book!
>  
> Next February FOSTER will bring together Open Science trainers and
> educators to collaboratively author a training handbook. If you have
> practical experience in implementing Open Science training at your
> organisation we’d love to hear from you.
>  
> What works, what doesn’t? How can you make the most of limited
> resources? With your help, we will create a handbook that equips
> future trainers with methods, instructions, exemplary training
> outlines and inspiration for their own Open Science trainings. The
> handbook will provide Open Science advocates across the globe with
> practical know-how to deliver Open Science principles to researchers
> and support staff. 
>  
> The handbook will be produced in a book sprint. You never have heard
> of that? This format will ensure a workshop environment in which a
> team of about 10 authors creates a finished book in four days
> collaboratively. Sounds crazy? Maybe, but let’s go for it! Join our
> writing adventure: Ten authors. Four days. One book.
>  
> We are looking for people from diverse scientific backgrounds, with
> Open Science expertise (from general to discipline specific) and
> experience in developing and delivering Open Science training.
>  
> So, if you would like to share your experiences and are motivated to
> be part of our team writing a handbook in just a few days, please
> apply using the form available at: https://goo.gl/forms/G6wwKMtKpuA00
> O9W2    
>  
> We will need information about your scientific background, your area
> of Open Science expertise, your training experience and of course
> your motivation to participate in our extraordinary writing
> adventure.
>  
> The book sprint will take place in Germany. Your travel expenses will
> be co-funded by FOSTER.
>  
> The call for expressions of interests will be open until Sunday, 1
> October 2017. You will hear from us by late October 2017.
>  
> Contact person
> If you have any questions or need clarifications, please contact
> Helene Brinken, University of Göttingen, State and University
> Library, brin...@sub.uni-goettingen.de  ngen.de>.
>  
> About FOSTER
> The EU-funded project FOSTER (Fostering the practical implementation
> of Open Science in Horizon 2020 and beyond) aims to support Open
> Science trainers in multiplying open access, open data sharing and
> open science principles.
>  
>  
> --
> Full post: https://www.rd-alliance.org/group/education-and-training-h
> andling-research-data-ig/post/foster-call-trainers-share-their  ://www.rd-alliance.org/group/education-and-training-handling-
> research-data-ig/post/foster-call-trainers-share-their>
> Manage my subscriptions: https://www.rd-alliance.org/mailinglist  ps://www.rd-alliance.org/mailinglist>
> Stop emails for this post: https://www.rd-alliance.org/mailinglist/un
> subscribe/57226  57226>
___
tg-foundational-training mailing list
tg-foundational-train...@lists.codata.org
http://lists.codata.org/mailman/listinfo/tg-foundational-training_lists
.codata.org

signature.asc
Description: This is a digitally signed message part
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Proposal to improve images on next lesson release

[Raniere Silva]

Hi all,

We are trying to not make any drastic change on the style/template but
keep improving it each release. For the next release, December 2017, I
would like to improve how we display images and for that I created http
s://github.com/swcarpentry/styles/issues/161. Comments from everyone
are welcome in the issue. If we didn't get into a consensus in the next
month or so I will ask the Lesson Infrastructure Subcommittee to make a
decision taking in consideration all the comments.

Thanks,
Raniere

signature.asc
Description: This is a digitally signed message part
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Credit for lesson contributors

[Raniere Silva]

Hi Kate,
Thanks for your email.
> If you've contributed to any of Software Carpentry's lessons in the
> near or
> recent past, please take a moment to fill out this quick (5 question)
> Google Form: https://goo.gl/forms/RBfbPmfirwAdjUcN2
> 
> This information will be used to make authorship attribution in
> lessons
> more robust by linking with your ORCID identifier 
> , and
> will also let you opt out of authorship for subsequent releases of
> particular lessons.

Why did you not just for people to fill the ORCID ID on their profile
on AMY? It is a much better option in my opinion.
Cheers,Raniere___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] June Community Call?

[Raniere Silva]

Hi,

the Software Carpentry Calendar has a "Community Call" schedule for
tomorrow but I didn't saw any information on the website or this list.
In addition, the etherpad for the "Community Call" is empty. Could
anyone confirm or cancel the "Community Call"?

Thanks,
Raniere___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] One-day syllabi using Carpentry material

[Raniere Silva]

Hi Kari,
> Does anyone have a one-day workshop syllabi based on Carpentry
> material?

I don't.
> Myself and two other instructors are writing an abstract to do a one-
> day
> pre-con workshop at the Professional Development Conference for the
> National Society of Black Engineers. We'd like to cover the most
> useful
> topics, and we only have one day.

If I had to write that abstract I would pick R gapminder lesson and
write the abstract around it.I would include some spreadsheets heads up
at the begin and cover
1. Introduction to R and RStudio2. Project Management With RStudio3.
Seeking Help4. Data Structures5. Exploring Data Frames6. Subsetting
Data10. Functions Explained15. Producing Reports With knitr
Cheers,Raniere___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Seeking technology for realtime sharing of notebooks

[Raniere Silva]

Hi Titus,
There was a service call DataJoy [1], now close, that could be
relevant.
I heard good things from Mike Croucher about Collaborative Calculation
in the Cloud (COCALC) [2], previous know as SageMathCloud. I don't know
if they have the features that Bill is looking for.
Raniere
[1]: https://www.getdatajoy.com/[2]: https://cocalc.com/ id="-x-evo-
selection-start-marker">___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] EuroPython 2017 - Software Carpentry Help Desk

[Raniere Silva]

Hi all,

I and Mateusz received the accept notification for our proposal of a
help desk during EuroPython 2017.

On Fri, 2017-05-12 at 14:15 +0200, Alexander Hendorf wrote:
> Dear Raniere and Mateusz,
> 
> I'm writing to you on behalf of the EuroPython 2017 program work group.
> We are very happy to inform you that your submission
> 
> Software Carpentry Help Desk - Start using Python and Git (help desk / 
> beginner)
> 
> has been accepted by the Europython program work group.
> 
> At this point, we cannot give the exact day and time, yet.
> We expect to publish the full schedule by end of May.
> 
> Thanks again for your submission, great work!
> 
> Best Regards,
> Alexander Hendorf
> @hendorf
> 
> as EuroPython board member & chair of the program work group
> 
> 
> EuroPython:
> https://www.europython.eu/
> https://twitter.com/europython
> https://www.facebook.com/europython
> 
> EuroPython Societyhttp://www.europython-society.org/

If you are attending EuroPython 2017, you very welcome to help us on
the help desk or pass by to chat.

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Teaching Python via CLI or Jupyter

[Raniere Silva]

> The other talk is a shorter talk (~20 minutes, incuding Q&A) about
> the
> differences teaching Python via straight command line compared to
> teaching
> from the Jupyter notebook.  When I've taught for the Carpentries,
> I've
> always used Jupyter.  In other contexts, I've taught strictly from
> the
> CLI.  I'm curious to know if others have taught in both ways (either
> for
> the Carpentries or in other circumstances) and what you've thought of
> it.
> Advantages/disadvantages?  What you like and don't like about Jupyter
> and
> CLI environments?

Some instructors already answered Maneesha's question but I want to add
my two cents.

Before I add my two cents, when I wrote CLI you show read Jupyter
command line instead of the standard Python command line because as you
know the standard Python command line "sucks", e.g. it doesn't support
auto-complete and don't let you access the previous command.

In all the workshops that I taught, I always had at least one student
who was taking notes with paper and pen. Is completely out of scope of
this email discuss "analog" vs digital taking note tools but I would
say that we should expect that some learners will try to keep their own
personal notes despite our use of Etherpad/Google Docs/... and I think
that among "IDE specific select and run", Jupyter Notebook and nano+CLI
the best experience to take personal digital notes and run the commands
is "IDE specific select and run". By "IDE specific select and run" I
mean that learners can type freely at a text file what they want, they
don't need to worry about comment notation, but they can select the
command they type and by pressing some keys they will run that command.
  Unfortunately, the price that you need to pay is explaining the IDE
that you pick to the students.

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] EuroPython 2017

[Raniere Silva]

Hi all,

I and Mateusz Kuzak wish to organise a panel during EuroPython 2017,
https://ep2017.europython.eu/en/, about teaching "research programming".
We are looking for two to four instructors that are planning to attend
EuroPython 2017 to take part on this panel.

As mention on EuroPython 2017 web site

> Since EuroPython is a not-for-profit community conference, it is not
> possible to pay out rewards for talks or trainings. For talks,
> posters, help desk and organising a panels or interactive sessions we
> will give out a 25% discount coupon valid for one conference ticket.
> (..) we can also only give out one coupon per talk, even the talk is
> given by more than one speaker.

And I or Mateusz can not provide panellist any financial help. Sorry for it.

If you are still interested in participate in the panel,
drop me a email until this Friday, 21st April.

If you know someone that is attending EuroPython and aren't on this
list, feel free to forward this email.

Thanks,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] nano clean the window scrool in Windows (was Re: nano not found after installing gitbash (Raniere Silva))

[Raniere Silva]

Hi Michael,

Thanks for your email.

> Please also consider MSYS2 or conda (which repackages MSYS2). Either offers 
> all the
> benefits of cygwin, but also handles Windows native paths more intelligently, 
> lowering the
> cognitive load.

I created
https://github.com/swcarpentry/workshop-template/issues/394 for MSYS2 and
https://github.com/swcarpentry/workshop-template/issues/395 for conda.

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Subtitles (closed captioning) for live-coding demo videos

[Raniere Silva]

Hi all,

> For Software and Data Carpentry instructor training, we use two videos 
> (starring yours truly) to demonstrate
> do’s and dont’s for live-coding: https://youtu.be/bXxBeNkKmJE and 
> https://youtu.be/SkPmwe_WjeY. We are
> looking for a volunteer to add subtitles/Closed Captioning to these videos to 
> enhance their accessibility.
> Instructions how to do this can be found here: 
> https://support.google.com/youtube/answer/2734796?hl=en.
> (There are automatically created subtitles for the ‘done good’ video, but 
> these are pretty poor).
>
> If this is something you think you could do, please let us know via this 
> github issue.
>
> On behalf of future instructors, thanks in advance!

Did Software Carpentry Foudation considere hire someone to do that?

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] nano clean the window scrool in Windows (was Re: nano not found after installing gitbash (Raniere Silva))

[Raniere Silva]

Hi all,

thanks for all comments!

> If you’re interested in more information about instructor preferences and 
> possible solutions
> for the second concern (text editors for the shell lesson), you will find 
> this issue of interest
> [2] and we hope you will continue to add comments there.
>
> For now, the Windows installer isn't working, so while we're working to fix 
> that, we'll add
> instructions for using Atom in a workshop. If you are an instructor teaching 
> the shell lesson
> soon and are comfortable using Atom (and helping your students get it 
> installed!), please try
> it out and add to this issue [3] to let us know how it worked. We'll get in 
> touch with people
> teaching upcoming workshops to let them know about this issue and potential 
> solutions.
>
> [1] https://github.com/swcarpentry/shell-novice/issues/542
> [2] https://github.com/carpentries/conversations/issues/11
> [3] https://github.com/swcarpentry/workshop-template/issues/390

If you prefer to use nano as the text editor
I will ask you to spend 10-20 minutes reviewing
https://github.com/swcarpentry/workshop-template/pull/391.
I spent a few hours working on it
and from my test, at a Windows 10 virtual machine,
it work OK.

Thanks,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] nano clean the window scrool in Windows (was Re: nano not found after installing gitbash (Raniere Silva))

[Raniere Silva]

Hi all,

today at the workshop,
one of the our Windows learners asked me why after quit nano the
previous command weren't available when scroll the window up.
The learner was very annoyed to not be able to see the history.

I would like to motion to change nano with Atom as the recommended/default
text editor for our workshops. I don't want to start yet another flame war,
we already had lots and lots of discussion about this,
so I will summarise the benefits and drawback of my proposal.
I will ask that before suggest another text editor instead of Atom,
stop and think that the text editor will benefit novice learners
instead of just make your life easy as instructor because you use X on
your daily work. (I don't use Atom!)

# Benefits

- Is open source.
- (Just) works in Windows, Mac and Linux.
- Easy to install in Windows, Mac and Linux.
- "All versions" are available to Windows, Mac and Linux.

  Some software, e.g. Skype, works in Windows, Mac and Linux but
  different versions are available to different OS.
- Configure PATH to be accessible from Git Bash.

  No need for extra configuration or our script to fix PATH.
- Well mantained and supported.
- Syntax highlight out of the box (AFAIK).
- Lots of plugins for learners that decide to keep using Atom.

  AFAIK there is a plugin that allow learners to use Atom
  to edit remote files, e.g. on clusters.
- Beautiful interface.

# Drawback

- Learners and instructions will need to switch windows.

# (My own) conclusions

Replace nano with Atom will avoid many of the our issues during the
workshop, such as "we will use nano but if you don't have nano you can
use X", and reduce the volunteer work that we need to maintain the
quality of our workshops. The price that we will need to pay is switch
windows during the workshop.

Thanks,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] markdown file with diffs

[Raniere Silva]

Hi Nathan,

>> I'm a new maintainer of the python-gapminder lesson.

Thanks to help us with the python-gapminder.

>> Quick question - When I look at a pull request, specifically the markdown
>> file with diffs (files changed), and click the "view" button on the upper
>> right, I get a sort-of rendered  markdown file but some of the markdown
>> remains raw - specifically python code and output.  Is there another button
>> in github to view what the proposed change will look like after final
>> rendering with Jekyl?  Should I go to the proposer's github.io site to see
>> the rendered file?

As Naupaka said, there is no other button. :-(

GitHub and Jekyll use different Markdown
parsers that are incompatible.

You can stop reading here since I will only add a few technical details
after this point. :-)

There is a few Markdown to HTML parsers write in Ruby.
The two more famous are redcarpet, https://github.com/vmg/redcarpet,
and kramdown, https://github.com/gettalong/kramdown/,
and they are incompatible.
As far as I could dig, looks like that GitHub started using redcarpet [1]
for their website rendering (Markdown files, including README, issues
and pull request, wiki, ...).
At some point, GitHub started using their own parser [2]
to support user notification, issues and pull request cross-reference, ...
but GitHub Pages stayed using redcarpet.
In 2016, when GitHub Pages moved to Jekyll 3.0 [3],
GitHub pages only supported kramdown as Markdown parser.
At that point, your Markdown file could be render different
at GitHub (parsed by GitHub own tool) and GitHub Pages (parsed by kramdown).

Because different websites use different flavours of Markdown,
some people started working in a "common" flavour
now know as CommonMark, http://commonmark.org/.
Early this month, GitHub announced that they are now using
a "patched" version of CommonMark [4].
GitHub Pages continue to use kramdown for now.

If you looked at [3] you should be questioning yourself
for why we are not using kramdown's GitHub-flavoured Markdown support [5].
We could but it would not solve the problem
which is due our use of kramdown's block attributes [6]
to style code blocks and call out boxes.
There is some discussion on CommonMark community [7]
about block attributes but will take more time for a consensus. :-(

Bests,
Raniere

[1]: https://github.com/github/markup/tree/v1.0.2
[2]: https://help.github.com/categories/writing-on-github/
[3]: 
https://github.com/blog/2100-github-pages-now-faster-and-simpler-with-jekyll-3-0
[4]: https://github.com/blog/2333-a-formal-spec-for-github-flavored-markdown
[5]: https://kramdown.gettalong.org/parser/gfm.html
[6]: https://kramdown.gettalong.org/quickref.html#block-attributes
[7]: https://talk.commonmark.org/t/consistent-attribute-syntax/272/108
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] "first-time contributor" badge in GitHub

[Raniere Silva]

Hi all,

a tweet [1] from Ben Balter showed up on my feed saying that

"(GitHub) Maintainers will now see "first-time contributor" badges if it's 
the author's first pull request to the project. Be sure to welcome them!"

I didn't find any official announcement at https://github.com/blog
but I think this is a very nice feature. :-)
If you find that badge on any of our pull requests please
be kind. :-)

Thanks and enjoy your weekend.

Raniere

[1]: https://twitter.com/benbalter/status/845305265159376896 
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] nano not found after installing gitbash (Raniere Silva)

[Raniere Silva]

Hi Evan,

Thanks for the email.

Maybe we should move this discussion to
https://github.com/swcarpentry/windows-installer/issues/2?

Ethan and Trevor,

Can you reopen the issue? I don't have permission.

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Docker Containers for Reproducible Research Workshop - Call for Papers

[Raniere Silva]

Hi all,

If you are interested in technology behind open and reproducible science,
the Docker Containers for Reproducible Research Workshop,
https://www.software.ac.uk/c4rr,
being organised by the Software Sustainability Institute,
https://www.software.ac.uk/,
might be of interest to you.

We are accepting abstract until 31st March 2017 at midnight,
more information at https://www.software.ac.uk/c4rr/cfp.

Best wishes,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] nano not found after installing gitbash

[Raniere Silva]

> I typically use Git Bash on Windows, and have students set Notepad as the 
> default editor for
> simplicity. However, looking at the requirements 1. Git, 2. Nano, 3. Make, 4. 
> SQLite, that all
> work from a single terminal, it seems like we should revisit using Cygwin. 

The main reason that we use "Git for Windows" is that we try
to avoid "exotic" tools. If you google "git windows" you will get

1. Download Git for Windows - Git - Downloading Package
   https://git-scm.com/download/win
2. Git for Windows
   https://git-for-windows.github.io/
3. Install Git | Atlassian Git Tutorial
   https://www.atlassian.com/git/tutorials/install-git
4. Git for Windows · GitHub
   https://github.com/git-for-windows
5. Download – TortoiseGit – Windows Shell Interface to Git
   https://tortoisegit.org/download/

Cygwin isn't on that list.
And we don't want to use SourceTree, GitHub Desktop or TortoiseGit
since we try to teach principles and not tools.

Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] nano not found after installing gitbash

[Raniere Silva]

> At a workshop this morning a few of our learners see a “nano not found” error 
> after installing gitbash on Windows.
>
> Is this a known error/bug? 

We have a few bugs related with nano. :-(
I had suggested to replace nano with Atom, https://atom.io/,
since it works on Windows, Mac and Linux machines,
https://github.com/atom/atom/releases/tag/v1.14.4,
plus is open source.

The arguments against the change was

(1) Switch windows is distracting for learners.
(2) We still need to install GNU Make
and makes it accessible from msysGit.
(3) We still need to install SQLite
and makes it accessible from msysGit.

I understand (1) but having "nano not found" is worse.
I don't have any data about how many workshops depend on (2) and (3).

Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Add "Edit on GitHub" link into lessons

[Raniere Silva]

Hi all,

Erin Becker's last survey showed up that some people
want to have the Edit on GitHub on the lessons
they access over GitHub Pages.

If you want to have that link or are agains it
please leave your comments at
https://github.com/swcarpentry/lesson-example/pull/104.

Thanks,

Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] GitHub Introduced Topics

[Raniere Silva]

Hi all,

GitHub introduced topics this week,
https://github.com/blog/2309-introducing-topics,
and our repositories need some.

To keep this list low volume,
please post your comments at
https://github.com/swcarpentry/styles/issues/130.

Thanks,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Shell Extras lesson: Porting to new template and related questions

[Raniere Silva]

Hi Kevin,

> Why, when the page detailing the Mailman lists,
>
>   https://software-carpentry.org/join/#discussion
>
> shows the discuss@ list as
>
>   unmoderated
>
> have all my messages to discuss@, so far, generated a
>
>   Your message to Discuss awaits moderator approval
>
> reply ?

Unmoderated means that everyone who has subscribed to that list can post
to it. Did you subscribed to it? If you did, I believe that your email
domain is on the blacklist of the email server.

I don't have administrator privilegies to the server so I can't test
my hypotesis.

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] One page syllabus for workshop

[Raniere Silva]

Hi David,

> Pitching a potential workshop in Riyadh in spring of 2017 and looking for a 
> one
> page pitch document with summary of core syllabus. Does such a document 
> already
> exist? If not I will be happy to craft one...

What type of document are you looking for?
We have some "old" and a little out of date material that you can use as
start point but before I dig the link to send to you would be better to
know what you are looking for.

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Steering Committee 2017 - Deadline for stand up for election is today

[Raniere Silva]

Hi all,

if you are planning or considering stand up for election to the Steering
Committee 2017 remember that today is the last day to inform us.
You can find more details at
https://software-carpentry.org/blog/2016/10/Call-for-candidates-SC-2017.html.

If you want to talk with someone to clear your mind,
your Steering Committee Secretary, me, is happy to talk with you.

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Steering Committee 2017 - Deadline for stand up for election is today

[Raniere Silva]

Hi all,

if you are planning or considering stand up for election to the Steering
Committee 2017 remember that today is the last day to inform us.
You can find more details at
https://software-carpentry.org/blog/2016/10/Call-for-candidates-SC-2017.html.

If you want to talk with someone to clear your mind,
your Steering Committee Secretary, me, is happy to talk with you.

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] GitHub introduced review requests

[Raniere Silva]

If you didn't notice the new GitHub feature on your GitHub repository
you can read about it at
https://github.com/blog/2291-introducing-review-requests.

We will love to hear how do you want that us use this new feature.

Bests,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Git Merge 2017 - February 3 to February 3, 2017 - Talk submission

[Raniere Silva]

Hi all,

is anyone planning to submit a 30-minutes talk to Git Merge 2017 [1] [2]
that will be host in Brussels? Git Merge will happen right before FOSDEM [3].

If anyone isn't submitting a talk I will give a shot.
Deadline for submission is Nov 21, 2016 at 12:00am PST.

Bests,
Raniere

[1]: http://git-merge.com/
[2]: https://cfp.githubapp.com/events/git-merge-2017
[3]: https://fosdem.org/2017/
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Markup for div on Markdown

[Raniere Silva]

Hi,

in the last two weeks some contributors to Pandoc started discussing
again the markup for div at https://github.com/jgm/pandoc/issues/168
and I thought that some instructors could be interested on leave their
suggestions and/or preferences on the GitHub issue.

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Local SWC Websites

[Raniere Silva]

Hi Pat,

> We need to develop an online presence for the U of Michigan SWC/DC group. I 
> was
> wondering whether anyone has examples of websites that have been developed for
> local partners/chapters to announce workshops, events, etc. that we could use
> as an example.
>
> Perhaps a long-term project could be to create a template for organizations to
> use as a start.

I remember the Steering Committee discussing something on this lines at
the in-person meeting last May. Belinda Weaver was the Steering
Committee member more interested to work on this but I believe that
other things go on the way.

I think this is something that could be assig for a task force,
http://software-carpentry.org/join/subcom_and_tf/.
Pat, would you be interested to lead that task force?

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Defensive Programming with R

[Raniere Silva]

Hi all,

thanks for a good discussion.

I opened a issue,
https://github.com/swcarpentry/r-novice-gapminder/issues/221,
for this.

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Prerequisites and outcomes

[Raniere Silva]

Hi,

> I would agree that indeterminacy of workshops exists because SWC has
> learned that not all lessons fit all disciplines or experience levels. A quick
> example is that version control is a tough concept unless learners have
> done at least some coding and have either lost a lot of work or broken a
> piece of code and want desperately to go back to a previous copy that
> they can't find. So for a particular level of learner a workshop may exclude 
> git or it may not. I think this analogy applies to most tools.

I agree with Cameron when he say "not all lessons fit all disciplines or 
experience levels".
I only want to add two cents:
all Software Carpentry workshops need to cover Git (or Mercurial or
another version control system). On a workshop with novice learners you
probably will not cover branches but on a workshop with learners that
have done at least some coding they will probably ask the instructors
about branch. ;-)

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Defensive Programming with R

[Raniere Silva]

Hi,

Thanks for all the replies so far.

I understand that the userbase of Python and R normally do different
tasks but the request for defensive programming/unittest with R
come from a possible host who as looking to best practices.

> I would be up for helping with it, not that I'm an expert on R though. 
> Raniere? Marianne? anyone who wants to lead it?

I can't lead but I'm happy to review any draft.

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Defensive Programming with R

[Raniere Silva]

Hi all,

on our Programming with Python,
http://swcarpentry.github.io/python-novice-inflammation/08-defensive/,
we have a "Defensive Programming" section.
This section is missing on the R lesson.

Any experience R instructor can let me know why?
And if you have your "translation" of that lesson in R
could you send me a copy of it?

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Fwd: Fortran Modernisation workshop at the University of Manchester

[Raniere Silva]

For those that have friends that use Fortran
and can't attend a Software Carpentry workshop
since we still don't cover Fortran.

Gerard Capes  writes:

> Dear Colleagues, 
>
> This two day hands on workshop is aimed at Fortran programmers within 
> computational science who want to
> write modern and efficient code, or modernise existing code, to make it more 
> readable and maintainable by
> encouraging good software engineering practices. The workshop will cover 
> tools and libraries that are
> commonly used in computational science and engineering. Click on the link 
> below for further details and
> registration:
>
> 2-3/FEB/2017 - 
> https://researchitnews.org/2016/09/27/fortran-modernization-workshop-feb-2017/
>
> Thanks
> Gerard 
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Strategies/techniques for accessibility (visual impairment)

[Raniere Silva]

Hi Nelle,

thanks for you tips to Leighton.

> - Make sure your material are accessible (in that case, readable with
> a screenreader). Schema should be avoided. Text is fine. Most pdf are
> accessible, most *simple* html is as well, but fancy javascript can be
> problematic.

I have the feeling that our online lessons aren't 100% accessible
and having them 100% accessible is something that I'm in favour
even if we need to raise the contribution bar a little.

I don't have a screenreader and I failed to setup the speech-to-text
last time that I tried. If you could ask one of your friends for 20-30
minutes to have a look on any sessions/topics of our lessons,
for example, http://swcarpentry.github.io/shell-novice/03-create/,
http://swcarpentry.github.io/r-novice-gapminder/05-data-structures-part2/,
or http://swcarpentry.github.io/python-novice-inflammation/06-func/,
and email me all the issues I will record the issues on GitHub
and try to address them for our next release.

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Strategies/techniques for accessibility (visual impairment)

[Raniere Silva]

Hi Leighton,

> We’ll be teaching a workshop soon, with a visually-impaired (blind) student.
> This is a new experience for me, and I was wondering if any of you might be
> able to share some advice for teaching strategies/approaches to delivering
> material that could be useful?

I believe that the Steering Committee will agree with me that
we will appreciate very much if you could write a blog post
about your experience with the visually-impaired (blind) student.

Thanks,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Teaching Git with Github Desktop

[Raniere Silva]

Hi Steven,

>> My two cents: the git command line interface is practically broken. I think
>> there's consensus on this, especially on this list. As such, I'm strongly in
>> favour of teaching git by GUI, because by and large GUIs have done a good job
>> of simplifying the process of interacting with git.
>
> I strongly disagree with that point. Why do think the git command line 
> interface
> is practically broken?

Git command line interface isn't friendly to new users
because "git checkout" do too much for the same command
depending of what arguments the user pass.
Why do we can't have "git undo" that ony works with the working copy?
Why do we can't have "git recovery" that only works with old revisions?
As a intermediate user I understand why all the actions previous
mentioned are under "git checkout" but for a new user this isn't clear.

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Teaching Git with Github Desktop

[Raniere Silva]

Hi Matthew,

> I searched the list history and didn't see a similar topic already posted, so
> apologies if this is a rehash of a previous conversation.
>
> I'm going to be teaching a version of the git novice lessons next week to an
> audience that does not feel comfortable on the command line. My goal will be 
> to
> use Github Desktop [1] which provides a (reasonably nice) GUI on top of common
> interactions with local and remote repositories. I expect to walk through the
> GUI interactions in approximately the same order as the lessons while having
> some conceptual slides as I go along.
>
> I have a few questions for the list:
>
> 1 Has someone else taught a similar course? Perhaps we can connect off list 
> for
>   quick ideas/lessons learned (I will be new to teaching with a GUI..).

Twice I had a request to teach Git using a GUI interface. None of the
request was for a Software Carpentry workshop.
In one of the class I use gitk [1] and git gui [2]
that are the official GUI for Git and is installed with Git for Windows
which we recommend (if you use Linux you need to run "apt-get install git-gui"
to have it). The feedback from the lesson was very positive except for
the GUI is ugly and minor GUI behaviours (you need to click on the icon
and not on the name of the file).
The other class I use GitHub Desktop because the learners already had
download it and was strugling to use it. The learners were happy after
the lesson to have more knowledge of how Git works but I many times I
had to answer questions with "because this is the way GitHub want you to work"
or "you can't contribute with this project because it is on GitLab,
Bitbucket, ... and GitHub for Desktop only works with GitHub".

If I had to teach again with a GUI I would go with gitk and git gui
because learners could use it with any host and they are available on
Windows, OS X and Linux.

> 2 Is there interest in developing some sidecar lessons to git-novice that use
>   the github GUI?

I believe that many instructors would like to have it
but most of us would agree that provide that lesson
is contradict ourselves. We normaly something like
"spreadsheets are evil, you can make a lot of mistakes with spreedsheets,
you need to repeat yourself when using spreedsheets,
Bash/Python/R are aweseome, you can avoid mistakes when processing your data
by using Bash/Python/R, you can do things faster with Bash/Python/R by
not repeating yourself".

> 3 Philosophically, is teaching git without the CLI antithetical to SWC's core
>   mission (i.e., is it doing more harm by obfuscating the mechanics of the
>   underlying tool)?

We obfuscate the mechanics of the underlying tool when using Jyputer
Notebook and RStudio as IDE and also when we use libraries that do too
much for beginers that they don't need to learn the basic stuffs
(e.g. how to open a file because they only need to provide the name of
the file to the library). So I don't think that using CLI is antithetical
for that reason but as I explained early for a full/branded Software Carpentry
workshop I would only teach Git with the command line.

Another reason that we teach Git with the command line is to allow
learners to practice more the shell in a friendly environment (the workshop).

Cheers,
Raniere

[1]: https://git-scm.com/docs/gitk
[2]: https://git-scm.com/docs/git-gui
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Excel errors.... (Tiffany Timbers)

[Raniere Silva]

Hi,

> Emily Jane asked a good question about what are the other options, aside from
> Excel, Libre Office, or text editors as a means for data entry.
>
> Forms, whose output can later be accessed as tabular data (e.g., CSV), are a
> solution I have used and liked. Proprietary database software, such as
> Filemaker Pro exists, and from my experience, is fairly user friendly. For 
> open
> source options, I would use Google forms, or if you want an option that 
> doesn’t
> have to be hosted on the web, you could try out Dean Attali’s shinyforms R
> package (works, but is still under development) [1].
>
> I especially like forms for data entry, as you can more easily constrain how
> the data gets entered (predefined columns, drop-down menus with limited
> options, etc), compared to the free-for-all that exists with a spreadsheet.
>
> I’d love to hear other’s favourite tools and opinions on this topic.

I also like to use forms. Something that I'm using now is validity of
cell contents on LibreOffice,
https://help.libreoffice.org/Calc/Validity_of_Cell_Contents,
but I need to keep my data on LibreOffice format rather than CSV.

Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Preferred communication tool used during teaching

[Raniere Silva]

> (ii) Slack has introduced some kind of throttling of adding new users:
> they will only invite new users to a Slack forum if at least 50% of
> the previous invitations have accepted. I ran into this at about 40 or
> 50 participants. This was not the case in June 2015, but had been
> introduced before June 2016. It could be a practical problem for some
> SWC courses.

At the end of last year, one open source project that use Slack
complained that they reach the maximum number of users. Adding all
learners to https://swcarpentry.slack.com/ will probably hit this issue soon.

Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] Sprints on August 27 at EuroSciPy

[Raniere Silva]

Hi,

if you are planning to attend EuroSciPy this year,
https://www.euroscipy.org/2016/,
I invite you to take part on the Software Carpentry sprit
that will happen on August 27.

EuroSciPy organizers said [1] that if you only want to attend the sprint
you don't need to buy the tickets for the conference.
So, even if you aren't attending EuroSciPy but live close to Erlangen, Germany
you can take part on our sprint.

Thanks,
Raniere

[1]: https://twitter.com/EuroSciPy/status/755036187174264834
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Teaching Unix shell with a synced file window - feedback

[Raniere Silva]

Hi Andrew,

> I've done a short demo script (https://github.com/lonsbio/data-shell)
> of using the Unix shell with a Finder window synced to the current
> directory. I'm not sure if this even good idea, or has been tried
> before, but I thought it would at least be interesting to do a proof
> of concept regardless.

Looks great. :-)

> It's Mac only at the moment as it uses Applescript.

I believe that we can't have the same code working on Mac OS X, Linux
and Windows. :-(

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Can get html to build from markdown! [victory]

[Raniere Silva]

Hi Gerard,

> Thanks both for the suggestions.
>
> Editing my Makefile to include the absolute path didn't fix things:
>
> Updating Pandoc manually did the trick. I was using the version from
> the package manager (and had checked for updates there, but only
> there).
>
> Thanks very much - saved me a load of stress!

Great that you manage to build the html. And sorry to request one
version of Pandoc that wasn't available on your package manager.

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Can't get html to build from markdown [appeal for help]

[Raniere Silva]

Hi Gerard,

>> Steps to recreate the problem:
>> 
>> $ git clone https://github.com/gcapes/git-course.git
>> $ cd git-course
>> $ make preview

I didn't had any issue. I also try

$ make -B preview

and no problem.

>> pandoc -s -t html \
>>  --smart \
>>  --mathjax \
>>  --template=_layouts/page \
>>  --filter=tools/filters/blockquote2div.py \
>>  --filter=tools/filters/id4glossary.py \
>>  -Vheader="$(cat _includes/header.html)" -Vbanner="$(cat
>> _includes/banner.html)" -Vfooter="$(cat _includes/footer.html)"
>> -Vjavascript="$(cat _includes/javascript.html)" \
>>  -o 01-introduction.html 01-introduction.md
>> pandoc: Error running filter tools/filters/blockquote2div.py
>> tools/filters/blockquote2div.py not found in path
>> make: *** [01-introduction.html] Error 83
>> 
>> $ pandoc -v
>> pandoc 1.12.2.1
>> Compiled with texmath 0.6.5.2, highlighting-kate 0.5.5.1.

Could you try update Pandoc to a newer version,
https://github.com/jgm/pandoc/releases?
The version you are using is a little old.

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

[Discuss] EuroSciPy 2016

[Raniere Silva]

Hi all,

are you planning to attend EuroSciPy 2016,
https://www.euroscipy.org/2016/?

If yes,

1. do you have interest to delivery our Python lesson?

   It will not be a Software Carpentry workshop!

2. do you have interest to work on our Python lesson
   during one sprint?

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] Please share old flyers and promotional materials from workshops

[Raniere Silva]

Hi Erin,

> I'm working on drafting up some one-page promotional materials for DC
> and SWC for different audiences. I'd love to have some materials to
> compare with - preferably as many as possible. If you have any old (or
> current) flyers for workshops or any other DC/SWC event or pitch,
> please send my way.

You can find some at 
https://github.com/swcarpentry/communications/tree/master/advertising.

Cheers,
Raniere
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/listinfo/discuss

Re: [Discuss] off-list Re: Numpy as the first section in the Python lessons?

[Raniere Silva]

Hi Alex,

> I am going to teach,

Great. :-)

> but this is going to be in Lund, Sweden.

I hope that you have a awesome time on your first workshop.

> I will probably prepare another one in Munich in the second half of
> September.

Thanks for that.

> I am also worried that the workshops in Europe are not being
> announced, at least the last time I checked two weeks ago.

Let me help fix it.

Can you send me the link for the workshop page?

Cheers,
Raniere

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

Re: [Discuss] Numpy as the first section in the Python lessons?

[Raniere Silva]

Hi Alexandre,

> I am preparing for the first time the python-novice-inflammation
> lesson.

Great. :-) If you want to talk with someone try to attend the discussion
sessions or email mentor...@lists.software-carpentry.org.
Pleople on the mentoring committee are happy to help you.

> I am also going to add in the beginning instructions on the most
> popular initial options on how to actually run the python code.
>
> I am struck on how the novice lesson directly starts with Numpy
> without explaining too much variable naming and assignment, for
> instance. In my case I will begin with students with very little
> programming experience.

We have a long discussion about that last year.
See 
https://github.com/swcarpentry/python-novice-inflammation/issues/127#issuecomment-114364830.
We got in a concensus but didn't had time to make the changes
on python-novice-inflammation yet.

> Could you please write me your opinion and experience about how you
> prepare the beginning of the python novice lesson?

Please check the last link. :-)

Raniere

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

Re: [Discuss] using dotfiles as an introduction to git?

[Raniere Silva]

Hi Eric,

for intermediate students (that are familiar with whoami, ls, cd, cp,
mv, rm) using dotfiles as an introduction to Git should be great.
But for novice students I would stay with a .txt file
because it will save time to explain dotfiles concepts
and avoid students problems with .bashrc.

Cheers,
Raniere

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

[Discuss] PyCon UK 2016

[Raniere Silva]

Hi,

if you are planning to submit one Data or Software Carpentry workshop
to PyCon UK 2016, http://2016.pyconuk.org/cfp/, please contact me.

Cheers,
Raniere

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

Re: [Discuss] Discrepancy between .md and .html in swcarpentry/git-novice

[Raniere Silva]

> So, Jekyll does not process the files at
>
> https://github.com/swcarpentry/git-novice

No.

We are using Pandoc plus some Python scripts.
The rules are on the Makefile.

Raniere

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

Re: [Discuss] Discrepancy between .md and .html in swcarpentry/git-novice

[Raniere Silva]

Hi Bennet,

> Maybe I'm looking in the wrong place or something, but I think that
> the .md file at
>
> https://github.com/swcarpentry/git-novice/blob/gh-pages/07-github.md
>
> should have the same text and such as the rendered files at
>
> http://swcarpentry.github.io/git-novice/07-github.html

We don't want to include the HTML on the pull request because it will
make harder to review it. Lessons maintainers will compile the HTML and
push it at their own discretion.

Lessons maintainers are discussion about release process of the lessons
and will have something better after July.

Cheers,
Raniere

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

Re: [Discuss] New Python Maintainer

[Raniere Silva]

Hi Azalee,

thanks for all the help with the Python lesson.

> I am please to announce that Valentina Staneva will be taking over the
> role of maintaining the Python lessons with Trevor Bekolay.

Hi Valentina,

welcome!

Cheers,
Raniere

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

Re: [Discuss] informal capstones

[Raniere Silva]

Hi Christina,

> It has been a few months since I taught a workshop, so this might be
> outdated. My comments relate to the mid-2015 version of the
> python-inflammation lesson. I have found that that lesson is too long
> to fit into a single quarter, so have experimented with augmenting the
> lesson content slightly, and spreading it over 2 quarters.

I agree with Doug.

> > I'm teaching on the second afternoon of an upcoming (Python)
> > Software Carpentry workshop and am figuring out what to do on the
> > afternoon of the second day. 
> > I already have some options, but if anyone on this list has
> > "capstone" or "special topics" materials that they've put together
> > for the final quarter of a workshop, even if it's super
> > unorganized/casual, I'd love to see it, both to get some ideas and
> > hopefully to avoid reinventing the wheel.

You can find some capstones at
https://github.com/swcarpentry/?utf8=%E2%9C%93&query=capstone.
If you mention the workshop that you will teach or the background of the
students people can suggest better resources.

Cheers,
Raniere

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

Re: [Discuss] good and free email list hosts?

[Raniere Silva]

Hi Karin,

> I am looking to set up an institute independent email list. Anybody
> got ideas for good, free, no advertising, non-spamming and
> non-sell-your-emails list host servers out there?

Except for the last one there is http://groups.google.com/.

Depending of the plans for the email list you can check

- https://riseup.net/
- http://www.inventati.org/
- https://aktivix.org/

Normally you need to request the list and one of the admins need to
approve it (what nornally takes a few days).

Raniere

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

Re: [Discuss] Outreach misconception about Data and Software Carpentry as piece of software instead of skills

[Raniere Silva]

Hi,

> I'm usually the first point of contact for general public inquiries
> about SWC & DC and don't think I've seen anything like this.

I should had make clear that what I described happend on a cold-call
scenario when you send a email to someone that could be interested in
Data or Software Carpentry and probably will hear about us for the first
time on that email. Maybe my cold-call had the problem of someone entering
the email exchange in the middle of it but the email has clear signs
of that person trying to understand Data Carpentry based on the website
(the email has more references to Data Carpentry than Software Carpentry).

Can the misconception be because of the language? Yes. But I don't think
this is the case.

> If this is just one person I don't want to put too much effort into fixing
> things - we will always have a random person here or there that is
> confused.

I think that I saw this misconception with one or more people in half of
the workshops that I taught. The number isn't high but I don't think it
is random.

> I think we're pretty clear that our lessons include R, Python, Shell,
> Git, etc. If anyone else has seen a pattern of misconceptions about
> what SWC or DC is please let us know so we can think about how we may
> need to adjust our message.

If you look on Data's and Software Carpentry's homepage you will not
find any reference to R, Python, Shell, Git, etc. You need to visit
Lessons to discovery that our lessons include R, Python, Git, etc.
Also you need to read very careful the page to discover the tools that
we cover on the workshops.

Cheers,
Raniere

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

Re: [Discuss] Outreach misconception about Data and Software Carpentry as piece of software instead of skills

[Raniere Silva]

Hi John,

> At one recent workshop, the host had advertised the workshop as an R
> workshop to participants. However, the host had requested a Software
> Carpentry workshop that included R as well as git, Bash, and SQL. We
> had a few participants who voiced their displeasure at covering
> anything other than R. One particular participant confronted me during
> a break about SQL. This learner already knew SQL and assumed everyone
> else did as well.

Thanks to share your experience. This was very interesting.
I always advertize our workshops as Python or R workshop
in social media but never had this problem. I'm not trying to blame
anyone but could you let us know if for that workshop students need to
register themselves going over our workshop template [1]
or this was an private workshop?

Cheers,
Raniere

[1]: http://github.com/swcarpentry/workshop-template

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

[Discuss] Outreach misconception about Data and Software Carpentry as piece of software instead of skills

[Raniere Silva]

Hi,

this week I was negotianting a workshop and the person that I was
talking to really believe that Data and Software Carpentry are two
softwares and the workshops are about the softwares itself.
That person probably spent a lot of time looking at Data and Software
Carpentry website (based the email that I received) so I want to know
if you already experience an similar situation because if this is a
common misconception we need to improve our website.

Cheers,
Raniere

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

[Discuss] Outreach misconception about Data and Software Carpentry as piece of software instead of skills

[Raniere Silva]

Hi,

this week I was negotianting a workshop and the person that I was
talking to really believe that Data and Software Carpentry are two
softwares and the workshops are about the softwares itself.
That person probably spent a lot of time looking at Data and Software
Carpentry website (based the email that I received) so I want to know
if you already experience an similar situation because if this is a
common misconception we need to improve our website.

Cheers,
Raniere

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

Re: [Discuss] Looking the part in Software carpentry t-shirts

[Raniere Silva]

Hi Benjamin,

> Hi all, looking over a few YouTube videos of Greg doing SC material I
> noticed in many he is in a pretty nice white shirt with he SC logo.
> Wondering if we could purchase one of these for giving workshops?

Yes. :-) You can order as many as you want at 
http://www.cafepress.com/swcarpentry.

> Is this something people think would be beneficial?

+1

Would be nice to have the Software Carpentry products on Cafepress's
branch in Australia and UK.

Cheers,
Raniere


___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

[Discuss] Data and Software Carpentry in-person Instructor Training in Edinburgh

[Raniere Silva]

Hi,

The Software Sustainability Institute will host the Data and Software
Carpentry in-person Instructor Training on 4-5th May 2016 in
Edinburgh. A number of attendees who have been ​on a waiting list for the
training have already signed up but there are still several places
left. If you want to take part in this Instructor Training please
register via Eventbrite,
https://www.eventbrite.co.uk/e/ssi-instructor-training-for-software-and-data-carpentry-tickets-24083863484.
 Once
you completed the registration, please fill in a short survey form,
http://goo.gl/forms/VpWYbL0tyY. The places for the Edinburgh workshop
are limited, however please note that we recognize the high demand for
Instructor Training in the UK and we are doing our best to meet that
demand.

Cheers,
Raniere

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

[Discuss] Of more than academic interest

[Raniere Silva]

Software Carpentry is mentioned by The Economist:
http://www.economist.com/news/science-and-technology/21695377-professors-unprofessional-programs-have-created-new-profession-more.

It is a shame that they didn't mention Data Carpentry.

Raniere


signature.asc
Description: PGP signature
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

Re: [Discuss] Julia lesson/tutorial?

[Raniere Silva]

Hi Tiffany,

> I may be working a little bit with Julia (language) with a
> collaborator.

I hope that you like the language. It has some nice features.

And I believe that you will not have problem learning it on the fly
since the syntax if very similar with Python but having arrays starting
at 1 instead of 0 and numerical arrays instead of generic lists as the
most important data structure.

> I have never used this language before. Do we have any
> lesson material being developed on this that I could be pointed to? Or
> does anyone know any good tutorials or lessons elsewhere on the web?

Good resources at http://julialang.org/learning/.

My suggestion is to read
http://docs.julialang.org/en/release-0.4/manual/noteworthy-differences/
and start working with your collaborator. When you need anything you can
search the documentation, http://docs.julialang.org/, or Google it. :-)

Best,
Raniere

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

Re: [Discuss] Steering Committee Election Results

[Raniere Silva]

> Please share in welcoming them. They represent 4 continents and 5
> nations, and come from a diversity of disciplines and backgrounds.

In this count I'm representing Brazil or UK? :-)

Cheers,
Raniere (now on UK)

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

Re: [Discuss] Election question

[Raniere SIlva]

> I also fully expected having to vote for 7 people.

I just received a new key for the election and the new link states:

"Please vote for as many as seven (7) candidates for the Steering
Committee."

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

Re: [Discuss] Election question

[Raniere SIlva]

I have the same question.

> Maybe I missed this but is there a reason we didn't use the same
> style of voting used last year?

I was trying to find a good group for the next steering committee
(since I was expecting to have 7 votes instead of 14 :>) and have to
choose only one candidate makes impossible to find a good balance
between activity zones/countries and new ones, backgrounds, gender, ...

Cheers,
Raniere

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

[Discuss] Lab meeting reminder - Starting now

[Raniere Silva]

Hi all,

we are just starting this month lab meeting right now.

Please join us at https://bluejeans.com/565111800/.
More info at http://pad.software-carpentry.org/swc-lab-meeting-2016-02-09.

Thanks,
Raniere

___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

Re: [Discuss] lesson material as pdf?

[Raniere Silva]

> I used to get them there:
> http://scf.rgaiacs.com/nightly/
> (not sure it is up to date)

They are up to date!


signature.asc
Description: PGP signature
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org

Re: [Discuss] lesson material as pdf?

[Raniere Silva]

> I recall there being an ebook version at some point, but my google-fu
> didn't find it. Did that exist too?

Yes. There is a EPUB version at http://scf.rgaiacs.com/nightly/.
The script that I use is available at
https://github.com/rgaiacs/swc-nightly-compiler.
And I patched the lessons with
https://github.com/swcarpentry/lesson-template/pull/281.

Fingers crossed to find a better place for it this year.

Cheers,
Raniere


signature.asc
Description: PGP signature
___
Discuss mailing list
Discuss@lists.software-carpentry.org
http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org