[Ccsf-campus-staff] collaborating with PeerLirbary

[Shauna Gordon-McKeon]

One of OpenHatch's new efforts is to identify contributions that newcomers
are well-suited to make to projects, that don't require a ton of start-up
time.  These are ideal for doing in a short time period (1-5 hours) and can
allow newcomers to get a sense of the project and the community and decide
whether they want to continue on. A lot of times they decide they'd like to
try something else, regardless of how suitable the project is for
newcomers.

You can view these tasks here:
http://example-osctc-site.github.io/curriculum/#newcomertasks
(Note that this is not the curriculum for the event on Saturday -- it's
OpenHatch's example curriculum.)

The three tasks we currently have up are:

- Testing the setup and installation instructions for accuracy,
readability, and follow-ability.  This is a great task to do in person,
especially if someone who is skilled at setting up the project in different
environments is available.  Many students can do this at once, to give you
a diversity of feedback on the topic.

- Improving accessibility.  A quick scan of the PeerLibrary website
suggests that your web presence is already quite accessible, so there may
be less for newcomers to do here.

- Cleaning issue trackers:  It looks like you have a bunch of open issues
so this could potentially be useful. Generally reproducing reported bugs on
different systems is the easier and more useful part of this task, although
testing out fixes can be very fun and educational, and useful for the
project as well.

It's not up yet, but we also recommend having students do user tests.  This
allows you to get fresh eyes on potential UX problems while also
introducing students to the project as users.

This is, of course, in addition to the particular tasks that your project
naturally has, which students might enjoy working on.  I see that you have
a great number of issues marked as "for new contributors".  For those, I
recommend identifying a few that students could conceivably make progress
on and make sure they have the following info in them:
http://opensource-events.com/#defining-tasks-for-attendees
If you'd like, I can help with this.

Let me know if you still have concerns about the project's suitability.

best
Shauna


On Mon, Sep 8, 2014 at 3:09 AM, Mitar <mmitar at gmail.com> wrote:

> Hi!
>
> We were talking a bit in the team and we worry about how suitable our
> project is for beginners. The issue is that we are observing that
> people need quite some time to get to used to it. We are using few
> non-mainstream technologies like Meteor, CoffeeScript, Stylus, so
> contributors often struggle initially. So I am not sure how suitable
> our project would be for the format you have for your workshop. On the
> other hand, this is something we have to somehow address in our
> project, so it might be a good opportunity to learn how. Personally, I
> sadly cannot go this Saturday because I have already one other
> commitment, but maybe Rodrigo you could just go and observe how it is
> done? Not sure here, just thinking it loud.
>
> So we made quite some documentation how to contribute, but there is
> still a lot to learn/know:
>
> https://github.com/peerlibrary/peerlibrary/blob/development/README.md
>
>
> Mitar
>
> On Sat, Sep 6, 2014 at 12:34 PM, Tyler B <tylerbrothers1 at gmail.com> wrote:
> > Hey Rodrigo,
> >
> > We are having a meeting on Google Hangouts on Monday at 6pm (that may
> change
> > to be a bit later) to discuss the flow of the event and where we could
> use
> > mentors. If your interested, I can send you an invite on Monday.
> >
> > For now, if you still interested in mentoring, please head over to
> > ccsf.openhatch.org and click "Volunteer as a Mentor" near the top of the
> > page. Filling out the information lets us plan on how much food to bring
> and
> > dietary restrictions.
> >
> > Sincerely,
> >
> > Tyler Brothers
> >
> >
> >
> >
> > On Thu, Sep 4, 2014 at 10:46 AM, Rodrigo Ochigame <rodkazoch at gmail.com>
> > wrote:
> >>
> >> I'm happy to attend. Anyone else?
> >>
> >>
> >> On Thu, Sep 4, 2014 at 10:23 AM, Tyler B <tylerbrothers1 at gmail.com>
> wrote:
> >>>
> >>> Hey everyone,
> >>>
> >>> We would love someone from PeerLibrary to come!
> >>>
> >>> We could use mentors to provide ways of contributing to their projects
> >>> through out the day. Most of the students here at CCSF are learning
> Java,
> >>> C++ and/or Javascript, typically with no more than 3 semesters of
> >>> experience. Some students will be more advanced, having self studied.
> >>>
> >>> In the past, it was found that having two mentors is nice. One to
> >>> instruct the group, one to answer specific questions a lost student
> might
> >>> have.
> >>>
> >>> Let us know if you can attend.
> >>>
> >>> Sincerely,
> >>>
> >>> Tyler Brothers
> >>>
> >>>
> >>>
> >>>
> >>> On Wed, Sep 3, 2014 at 3:13 PM, Shauna Gordon-McKeon <
> shaunagm at gmail.com>
> >>> wrote:
> >>>>
> >>>> Let me try actually CCing people.
> >>>>
> >>>>
> >>>> On Wed, Sep 3, 2014 at 6:12 PM, Shauna Gordon-McKeon
> >>>> <shaunagm at gmail.com> wrote:
> >>>>>
> >>>>> Hello Tyler, Katherine, et al,
> >>>>>
> >>>>> Sending a quick email to introduce you all to Mitar, Camille, Rodrigo
> >>>>> and Tony, some of the developers of PeerLibrary, an open source tool
> for
> >>>>> sharing and discussing academic articles.  They're interested in
> potentially
> >>>>> mentoring at the event, and more generally building connections with
> CCSF
> >>>>> students.  They have all been CC'd.
> >>>>>
> >>>>> Do you think there's space for PeerLibrary at the event?  If there
> is,
> >>>>> and if one or more of you can attend, we can talk about how to
> facilitate
> >>>>> onboarding students onto your project.
> >>>>>
> >>>>> best
> >>>>> Shauna
> >>>>
> >>>>
> >>>>
> >>>> _______________________________________________
> >>>> ccsf-campus-staff mailing list
> >>>> ccsf-campus-staff at lists.openhatch.org
> >>>> http://lists.openhatch.org/mailman/listinfo/ccsf-campus-staff
> >>>>
> >>>
> >>
> >
>
>
>
> --
> http://mitar.tnode.com/
> https://twitter.com/mitar_m
> _______________________________________________
> ccsf-campus-staff mailing list
> ccsf-campus-staff at lists.openhatch.org
> http://lists.openhatch.org/mailman/listinfo/ccsf-campus-staff
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openhatch.org/pipermail/ccsf-campus-staff/attachments/20140908/da6b7ac4/attachment.html>