Intro: Participating in the community - getting started with Labs

[rufuspollock]

• [x] Who can participate (anyone)
• [x] Pre-requisites
• [x] Example starting points ...

Items to be done for this issue:

• [x] About (v short)
• [x] Types of activity
  • [x] Data wrangling
  • [x] Coding
• [x] Data Wrangling
  • [ ] What kind of things
  • [x] What kind of skills
  • [x] Actions
    • [x] Walk through a real example in the data wrangling guide => /data/
    • [ ] What can I start doing now? “Well we have a lot of data wrangling in our core datasets project -> check it out”
• [ ] Link /contribute/ from front page (first left hand box)

[gsilvapt]

DONE. See http://datapatterns.org/core-guides/getting-started/. Warning: Link may change in the future.

[rufuspollock]

@gsilvapt when closing please link to output (e.g. relevant online page(s)) that are the resolution. e.g. write

FIXED. See http://okfnlabs.org/handbook/{page}

[rufuspollock]

@gsilvapt can you actually do and post the link to the relevant pages here ...

[gsilvapt]

I posted it above. It is here: http://datapatterns.org/core-guides/getting-started/

This page answers who can participate, pre-requisites (none, I guess), and it also works as a starting point (the labels in the issues page).

[rufuspollock]

@gsilvapt - sorry missed that you had edited a previous comment. BTW the okfnlabs.org/handbook/ domain is now working so let's use that i.e.

http://okfnlabs.org/handbook/core-guides/getting-started/

[rufuspollock]

@gsilvapt having look at this this seems to be a guide to contributing to core datasets project not "getting started with labs" in general eg.:

As mentioned before, this is the place to start if you are interested in participating the Core Datasets project.

As such isn't this more about #90? I am therefore re-opening and suggest you post in #90 about this.

[gsilvapt]

@rgrp: Only "What kind of things" is missing. I remember we discuss something about Jekyll and list iterations, but I am not sure how to do that. Should we meet for that?

[rufuspollock]

@gsilvapt i have now reviewed the page and we still seem to have a lot not there. Main comments:

• Who can participate in Labs - not there yet
• Pre-requisites: missing - what do you think should go here ...
• Example starting points: none that i could see. No discussion of main projects people might contribute to
  • OpenSpending
  • Core Datasets
  • other priority projects from okfnlabs.org/projects/
• Types of activity - could merge this with previous item - so types of activity has under data wrangling and coding example projects you can contribute to (no problem having same project in both coding and data wrangling but with different emphasis on activities)
  • Coding: Nothing about coding the project
  • Data wrangling
  • "Skills required" section is far too stringent (and is copied from old patterns section).
  • What kinds of things needs doing (already covered in comments above). There is a link to core datasets but you need a short description, even a screenshot of what this ... (could borrow much of this from okfnlabs.org/projects/ listing ...)

[rufuspollock]

@gsilvapt propose prioritising this. Also then ping on the gitter channel (okfn/chat) to ask for feedback about this ...

[gsilvapt]

@rgrp I have reviewed this items and think about them for a while. I have some questions I think it is pertinent to discuss beforehand.

• Who can participate in Labs - not there yet
  • I think it is important to add that people will inevitably have to learn something at some point
• Pre-requisites missing - what do you think should go here ...
  • Some items I could think of: GitHub account, familiarity with Git and GitHub, regular presence in the forums and in gitter chat, ... Any particular suggestion?
• Example starting points: none that i could see. No discussion of main projects people might contribute to
  • I can add those to the "Get started" list. I will do it today.
• Types of activity - could merge this with previous item - so types of activity has under data wrangling and coding example projects you can contribute to (no problem having same project in both coding and data wrangling but with different emphasis on activities)
  • Coding: Nothing about coding the project
  • We were to discuss this item in some other time. Maybe now it is convenient.
  • Data wrangling
  • "Skills required" section is far too stringent (and is copied from old patterns section).
    • Those were the instructions. I can draft something to ease of the requirement list, yes.
  • What kinds of things needs doing (already covered in comments above). There is a link to core datasets but you need a short description, even a screenshot of what this ... (could borrow much of this from okfnlabs.org/projects/ listing ...)
  • Not sure if I understood this item. You mean a priority list of projects?

When we get the items sorted out, I can prepare a timeline to finish this issue.

[rufuspollock]

@gsilvapt all suggestions here look good - please go ahead and draft for the sections where you suggest creating a draft.

/cc @danfowler so he can keep an eye here too ...

[pwalsh]

@rgrp i wasn't really paying too much attention here, but great effort!

@danfowler please check out all the work happening here, and ensure it aligns with things you'd expect to see in a Labs Handbook.

[pwalsh]

@rgrp also, are you targeting this as a "Labs handbook", or, as "Guides and introductions for participating in the Core Datasets Project.", which is a bit different.

[rufuspollock]

@pwalsh there are two parts here:

• Labs handbook
• Core Datasets guide (migrated from data.okfn.org)

Idea was that working on core datasets was one of the main "intro" projects suggested in labs handbook. More of the structure in #94 (though a bit out of date - @gsilvapt perhaps you could update #94 with info from our shared doc ...)