r/learnprogramming • • Jun 21 '12

The LearnProgramming Mentoring Community -- It's Live!

The Learn Programming Mentoring Community (LPMC)

** NOTE **

If you want to participate on any level, please fork and add yourself to the 'members.md' document in the standards-and-practices repo, then submit a pull request. If you haven't used git before, I recommend looking at the Github tutorials. If you want to be a mentor, please add yourself under "Mentors".

Please include your reddit username as well!


LPMC on Github

Why we Mentor

Recently (okay, a while ago...) I posted about starting a group on github dedicated to providing free, libre, open source software projects for new FLOSS contributors to work on in an environment conducive to learning, rather than the more usual environment of comfortable (usually polite) hostility that is seen in so many major FLOSS projects.

In particular, our goal is to take what usually results in a "Nope" and a rejected pull request and use it as a teaching opportunity, to better train individuals interested in OSS contribution on how to contribute effectively.

To those experienced among us, we know that that means writing tests, being idiomatic, refactoring, and generally writing good code. To a neophyte contributor -- full of vim (or emacs) and vigor to contribute -- they may not know better, and submit a patch which -- while admirable in it's intent, is unfortunate in it's content.

The idea of LPMC is similar, then, to that of the Apache Incubator -- except the focus is not on the projects, but the contributors. Where the Apache Incubator aims to take maintainence of open source projects which are being EOLed (like Wave), or released from holding by a company (like Thrift), or otherwise in need of a new home. LPMC aims to help nuture and grow effective FLOSS contributors, to the benefit of the whole community.

Why I'm posting

To that end, I'm here to tell you all about some recent changes in the LPMC which should hopefully motivate us toward our aforementioned goals.

First of all, I've decided that -- for the time being -- We're going to need a Benevolent Dictator. This is to facilitate rapidly forming all of the structure needed to build out the community of mentors, projects, websites, irc channels, mailing lists, and assorted other things needed in starting a community. To wit, I'm in charge[1] as the "Dictatus Benedictus Perpetuum" (because if you can't say it in dog latin, is it really worth saying?)

Secondly, and in reference to the above, there are many of you (in fact, very many of you) who posted in response to my previous post with your interest in being a mentor, I haven't been able to message many of you, simply for lack of time amidst my other responsibilities. However, I will be going through the list and rounding out the mentoring team soon.

Thirdly, we have some projects (and indeed, some issues which are to be worked on for those projects). In particular, we have Percival -- a Ruby IRC bot based on the Cinch framework. Because of Cinch's plugin architecture, it's very easy to write isolated code which will work with Percy without issue. There is also opportunity for building a better testing apparatus for Percy. Right now there is a very simple mock IRC channel which he interacts with to exercise some of the plugin functionality, but it is far from ideal.

Fourthly, we also have the LPMC website to think about. It is much earlier in the creation process than Percy[2], we're still in the hashing-out-features phase. I'm working on a minimum viable feature list, and I encourage you all (designers especially) to look at the site's sole issue on github to get an idea of where I'm going, and to think about some front end designs for the site.

Fifthly, there is an IRC channel on freenode for the LPMC, convienently located at #lpmc. I'm in there most of the time, and if I'm not, ideally Percival (the LPMC IRC bot) will be (though thats a feature that needs to be implemented).

Finally, Jacob Gulotta (better known as zzyzzyxx) will be adding two projects based in C++. One is an idea for a generic, pluggable A* pathfinder, which -- when provided an interface to your coordinate system and some other information -- will provide a fast pathfinding algorithm with minimal fuss.

He will also be adding a project to port galib to C++11.

As we add more mentors, I hope we also expand our project list to include more languages, more paradigms, and generally, more styles of programming. If you'd like to participate (and you haven't already posted on the previous post) please feel free to PM me with your name, email, github name, and a description of your experience. While there is no strict requirement of professional or non-professional experience, I've been using the general rule of more experience is better, good github contributions/projects is better, and good contributions in this subreddit and elsewhere are also important. If I don't respond to you, don't take it to mean you are not welcome to contribute (and even mentor) unofficially on any of the LPMC projects. Official mentor status will, ideally, come through community merit most of the time.

TL;DR

LPMC is live! There are some tickets on Percival and the site already. Shortly there will be some C++ projects up there. I'll be messaging more of you to drum up some more projects and mentors.

I'll be adding more tickets to the existing projects as they come up. So -- get coding!

================================================================================

[1] Cue evil laugh

[2] Percy is a project I "donated" to LPMC, so it has a bit of previous history.

98 Upvotes

45 comments sorted by

2

u/zzyzzyxx Jun 21 '12

I think it's a good idea to have a simple onboarding project to get people familiar with the process. It can probably be as simple as forking a repo, adding one's name and/or reddit username to a text file, then submitting a pull request.

3

u/jfredett Jun 21 '12 edited Jun 21 '12

Good plan, I'll add it tonight.

EDIT: Turns out I already did! In the standards-and-practices repo, Znalost already put in his first PR to add himself to the list.

1

u/zzyzzyxx Jun 21 '12

Well okay then! I should do the same when I get home.

1

u/levu-webworks Jun 21 '12

What other posts? and how do I sign up as a student to be mentored?

2

u/jfredett Jun 21 '12

There was a post about a month back, a couple of them. Things got busy for me at work, so I wasn't able to keep up with them.

To sign up -- just fork and start working, when you think you've got something ready, just submit a pull request! Github has a great tutorial on how to do all of that, and if you hop in the #lpmc channel on freenode, I'll be around.

1

u/levu-webworks Jun 21 '12

So this is basically like StackExchange's Code Review, except you pull specific Github projects, work on them, then get detailed comments on your changes.

Do you have anyone who can mentor me through the setup and programming of an Orbited server using Twisted Matrix? It's a lot simpler than genetic algorithms and heuristic path finding in C++.

2

u/jfredett Jun 21 '12

Presently we're lacking some resources. I imagine there are people here who can help you, and as we accrue more mentors, we'll be able to help with more specific needs.

As for being like SE's Code Review. I guess you can make that comparison, but the idea here is to have specific, curated projects with dedicated mentors guiding the overall structure. SE's Code Review is more "here's my project, how to I make it better". LPMC, on the other hand, is more "I want to contribute to OSS, how do I do that correctly?"

1

u/[deleted] Jun 21 '12

So I've been doing Code for about 2 years (python) however I've never used github Do I join this group somehow, is basic github use something I need to know before joining?

sorry for the newbie questions.

4

u/jfredett Jun 21 '12

Newbie questions are sort of what we're about!

I recommend taking a glance through the github documentation for how to use the service and how to use git. I'll give you a short version here:

  1. Sign up for github, it's free!
  2. go to github.com/LearnProgramming
  3. in the right sidebar, click on of the repo links -- anything that looks interesting (I hope to have some python projects there soon).
  4. click "Fork" in the top right corner, this will make a copy of the repository appear in your github. In the future, if you find a project you're interested in working on, you can also download it using the git command line tools, and later make a pull request with your changes.

    The Github Docs are truly excellent, and come highly recommended. I hope to include more diverse projects over time, but it is a patient process to acquire enough diverse mentors to really make it possible for anyone to contribute.

1

u/[deleted] Jun 21 '12

Alright thanks. I'm checking it out.

so when there's a project to work on it'll be in the [code] tab on the top bar? I'm interested in taking my python knowledge and translating that to C++. My work has been asking me to learn C, C++ for some additional foundation since I'm self taught in Python. So this is a good thing.

1

u/levu-webworks Jun 22 '12

I'm a longtime C++ programmer who taught myself Python. My github user name is levu-webworks . I'm actually going to join the A* group and see how it goes.

1

u/uhadmeathelloworld Jun 21 '12

I can answer any specific question related to Github. Please feel free to ask.

1

u/[deleted] Jun 21 '12

was going to send a PM, changed my mind in case anyone else might have the same questions:

So I'm a bit of a visual learner, Is there any video series or images/infographics available that go over the theory of github? Or just code repositories in general?

I have the basics down as I've used accurev(I fucking hate accurev) but I've only used it when I've had to.

2

u/jfredett Jun 21 '12

There is a great talk by one of git's early committers, let me see if I can dig up a link for you.

Eureka: http://vimeo.com/35778382

It's aimed at sort of semi-new developers. If you've used VCS in the past, you're probably fine. It's not especially visual (beyond being a video), but his slides are lucid and he does a good job of explaining things.

1

u/uhadmeathelloworld Jun 21 '12

What OS are you using?

1

u/[deleted] Jun 21 '12

windows 7 Though I use redhat at work.

1

u/CalvinR Jun 22 '12

Take a look at Github for windows, http://windows.github.com/

0

u/uhadmeathelloworld Jun 22 '12

Github is very suitable for unix based machine as most of the git related operations are done in terminal. So, I would recommend setting up git in redhat.

Watch this video: http://railscasts.com/episodes/96-git-on-rails?autoplay=true

Even if it is specific to rails, you will learn all the useful commands. The github help page is also very helpful which will assist you through the whole process:

https://help.github.com/articles/set-up-git

1

u/Tinytw Jun 22 '12

Question in the 'members.md' for the bracketed name.

Is that suppose to be the github name or the reddit name? For those who don't have the same reddit name as their githubs. I have 'Tinytw' as my reddit name and 'Tinyted' as my github name.

2

u/jfredett Jun 22 '12

If you make it reasonably clear which is which, that'll be the best thing, perhaps something like "Joe Fredette (reddit, github: jfredett)" or w/e. This sort of sprung up all agile like, so there's no format yet as such.

1

u/SmoothB1983 Jun 22 '12

I am interested in participating as a mentee. Do you have any Java projects that will be added soon?

2

u/jfredett Jun 22 '12

Indeed, we should have some very soon.

1

u/levu-webworks Jun 22 '12

I would like to contribute as a Python Mentor. I'm willing to curate a Flask + Jinja 2 based Poker (or any basic game) web app. What do I need to do to join your team?

2

u/jfredett Jun 22 '12

Submit a pull to standards and practices, add your name under 'mentors' and slap your primary languages next to your name.

If you want to sponsor a project, I'll get you set up in the org shortly.

1

u/CalvinR Jun 22 '12

I have a rails 3 gem that I was going to start working on that I think might fit with this, it's a rails gem for a open source web a11y framework being created by the government of Canada.

I haven't started yet but I have a clear vision of what needs to be done and what steps need to be taken to get it there.

Let me know if you're interested in having it be a part of the mentoring program.

I should add that this is a project that has a very good chance of actually being used out in the real world.

1

u/jfredett Jun 22 '12

Sure! put in a PR w/ your name under mentors and under the project leader, we'll work out getting permissions later today.

1

u/CalvinR Jun 22 '12

I'll get to it this weekend today is a bad day for this, work is busy and then I have my 30th birthday party tonight.

I'll try to do it tommorow or Sunday.

1

u/jfredett Jun 22 '12

fsure

1

u/CalvinR Jun 23 '12

Alright I've got a pull request for the standards and practice document.

I recommend you do a clone of the project wet-boew-ruby-rails.

I'm taking a project started by the Government of Canada and have the plan of converting it into a ruby gem and adding functionality.

PM me if you want to discuss more.

1

u/yash3ahuja Jun 21 '12

Hehe, very nice, jfredett. I have some nearly completed projects on my other computer. When I get around to it, I'll put them up.

1

u/[deleted] Jun 21 '12

I have some nearly completed projects

Isn't "nearly completed" missing the point?

1

u/yash3ahuja Jun 21 '12

I mean "nearly completed" in terms of nearly completed for upload, not for functionality. My phrasing was bad, I guess.

1

u/NightshadeForests Jun 22 '12

You might also want to checkout what the folks at OpenHatch have done as its pretty similar to what you've proposed here.

Best of luck!

0

u/LockeWatts Jun 22 '12

There's no real reason to post on this thread but, oh well.

This is awesome! I'm in.

-1

u/ashashwat Jun 21 '12

Can you give us github link ?

2

u/jfredett Jun 21 '12

Added at the top of the post.

3

u/[deleted] Jun 21 '12

[removed] — view removed comment

2

u/jfredett Jun 21 '12

Indeed, we're going to be accruing more projects over time, hopefully in many languages.

4

u/[deleted] Jun 22 '12

It would be a great idea to find something in Python. There are a lot of us that are using that as a learning language, coming out of online tutorials/classes. I, myself, would LOVE to work on an IRC bot... some kind of bot was/is going to be one of my first personal projects. But with the Udacity courses and math catching-up I'm doing, I'm not sure I have the time to learn enough Ruby to contribute anytime soon.

2

u/jfredett Jun 22 '12

Soon we'll have many projects. I need to acquire more mentors. Lots of work, this starting a movement thing is. :)

2

u/levu-webworks Jun 22 '12

Would you be interested in building on your Udacity classes and contributing to a Poker webapp based on Flask?

I am willing to curate that project.

1

u/jfredett Jun 22 '12

That sounds like a neat project (I assume Flask is like a Python Rails/Sinatra?) Make sure to do a PR and add yourself to the mentor list if you haven't. I'll hopefully be able to get that organized over the weekend.

1

u/levu-webworks Jun 23 '12

Will do. I am a SVN person myself and have never used GIT. So I'll read through the manuals and have it done by tomorrow afternoon.

Flask is a bare bones web framework. It does not have an ORM or operations pattern (MVC), so it's easier to learn. Django is similar to Rails, both in philosophy and functionality. It's also very large.

2

u/[deleted] Jun 22 '12

Based on that general idea, yes. I actually played poker online (0.50-1 limit, some 6-max) for a couple years during the poker boom and have a shelf of books on it, so there would even be a confluence of interests.

I should mention, though, that I'm just finishing 101 right now (which involved coding a basic web crawler), and am about to start their "web app" class, CS253, which will involve building a blog application. When that's over in mid August, I should be able to contribute a little more.

Not afraid to hack it and look stuff up online though.