Giter Club home page Giter Club logo

nairuby.org's Introduction

Build Status

Preamble

The Nairobi Ruby Brigade or nairuby or nai.rb, is a User group for Ruby programmers based in Nairobi, Kenya. We would like to welcome all programmers that are interested in the Ruby language, tools, libraries and frameworks.

We have been meeting since August 2011 for presentations, demos and discussions applicable across various skill levels from beginner to advanced.

This repository contains the source code for our website nairuby.org and is powered by Jekyll, a static site generator.

Installation & Setup

Assuming that you have Ruby installed on your machine, follow the instructions below:

# Install Jekyll
gem install jekyll

# Clone the repository using git (see for git installation)
git clone [email protected]:nairuby/nairuby.github.io.git

# Change the directory to nairuby.github.io
cd nairuby.github.io

# bundle the app
bundle install

# Run a local copy of the website
jekyll serve --watch --safe --trace

# Point your web browser to localhost
http://localhost:4000

To run Jekyll such that you match the GitHub Pages build server (useful for debugging), run Jekyll with Bundler. All this does is run Jekyll with the dependencies specified in the Gemfile.

bundle exec jekyll serve --watch --safe --trace

Testing

The first test checks if Jekyll is able to build our site successfully by running jekyll build. The second test involves running HTML::Proofer which is a set of tests to validate our HTML output. These tests check if our image references are legitimate, if they have alt tags, if our internal links are working, and so on. It's intended to be an all-in-one checker for our output.

Running these tests has been simplified for you into one simple command, which is:

bundle exec rake test

See Rakefile in the source root for details or what comprises the test. Also note that automated tests are configured and set up to run on Travis-CI. Any push or pull request will be built.


For more information about Nairuby, visit nairuby.

nairuby.org's People

Contributors

itskingori avatar banta avatar bkmgit avatar jkoech avatar ggklf avatar dependabot[bot] avatar mogetutu avatar montell avatar mboya avatar

Stargazers

Daniel Schömer avatar Daniel Otieno avatar Khwilo Kabaka avatar Mwaoshe Njemah avatar  avatar

Watchers

David Yoon avatar  avatar Paul Oguda avatar James Cloos avatar Mwaoshe Njemah avatar Kinyanjui N. avatar  avatar  avatar Martha Chumo avatar  avatar MK avatar Christian Reuterwall avatar Josh Maina avatar Daniel Otieno avatar Harrison Kamau avatar Judah avatar

nairuby.org's Issues

Nairuby "Learning Resources" page

This page exists but isn't public in the sense that it's not linked to in the homepage and kinda isn't styled (I'm working on styling for pages) ... but it's ready enough for commits to add links to it ... navigate to nairuby.org/learn/.

The plan is to create a "Learning Resources" hub ... see here for the source file to be a comprehensive learning resource centre section depending on the different facets of Ruby programming.

Going forward we should you populate that instead of the homepage and link to it ... what's there is just a placeholder. Just pushed up the structure so that you can see what I'm talking about.

@GEORGEG This is in light of your latest pull request #16 changing all learning resources to strict Ruby, from Rails. Which was was an oversight that might have ended up turning the community into a Rails user group 👍

With this approach everyone can contribute learning resources within their area of focus.

Create pages and update links

Currently the homepage has links that are either broken or non-existent ... these need updating:

  • Pages that need to be created:
    • Meetings page
    • Presentations page
    • Code of conduct page
  • Links that need to be updated:
    • Main mailing list
    • Beginner's mailing list
    • Twitter page

These pages aren't linked to but might be good to have in the future (these could just be a section on the homepage):

  • How to contribute page (including what needs contributing)
  • About/history page
  • Members page (list with avatars, I think)

Update organisation page with logo and url

At the moment we are using the logo from the PDX Ruby Brigade ... since we don't have one. We should update this logo on the organisation page as well as add nairuby.org as the organisation official page ...

Looks bad right now.

screen shot 2014-04-13 at 11 57 20 pm

Improve navigation

We should have a navigation bar or side bar to show all the pages in the site.

Right now in order to know the pages that exists in the site one has to go through the home page from top to down and discover the pages by clicking links... so I recommend we create a navigation bar or side bar that will list important pages in the site.

Create Code of Conduct

Also could be referred to as Community Participation Guidelines

A good example would by Ubuntu's Code of Conduct v2.0 which is licensed under the Creative Commons Attribution-Share Alike 3.0 license. We may re-use it in this project, and modify it as we wish as long as we allow others to use our modifications and give credit to the Ubuntu Project!

Setup an IRC channel

It would be very welcome to set up an IRC (internet relay chat) channel. IRC is a great way for people who don’t otherwise know each other to meet and interact. I will suggest setting it up at Freenode

Freenode is an IRC server with a very specific mission: “to provide discussion facilities for the Free and Open Source Software communities, for not-for-profit organizations and for related communities and organizations”. It is a very friendly place and active moderators keep it comfortable and inviting.

"It is a great place for people new to a technology to learn the ropes, meet like-minded professionals, and help others."

Should we create a membership page? ... and what will be it's function?

Would like to discuss if we should have a membership page and what exactly will be it's functions.

I guess not everyone would want to be listed publicly as a member i.e. privacy concerns.

Or should we just leave membership to participation ... i.e. those people who participate and are subscribed to the mailing list.

This ultimately will require us to define what/who a member is ...

Repository cleanup?

I don't know if I'm being a control freak :-) but I think we should clean up some repos that were created when everyone had admin i.e. push access.

Personal projects should be on member profiles ... and if they scale then they should/could transferred to the organisation profile after which everyone else can contribute by sending in pull requests.

The Nairuby GitHub organisation namespace should only house projects that are related to the organisation collectively.

These seem to be defunct personal projects;

This one seems defunct as well and lacks proper documentation to explain what it's purpose is so that someone else could e.g. take it up);

This one should stay 👍

What is the best communication approach going forward?

Currently there seems to be two communication approaches for Nairuby ...

For consistency we need to decide which one will be the official communication channel.

At the moment, the site links to the [email protected] ... which is an assumption on my part.

My two cents is that with a proper website (which is what we are developing now), we just need [email protected] and keep it active ... it's easier to use and most of the members probably have Google accounts already.

Oh and Twitter.

Let's discuss.

Add entry on rubyusergroups.org

@GEORGEG There's a listing of Ruby user groups around the world at rubyusergroups.org with an entry "Nairobi Ruby Users Group" in Kenya. Seems like you were the one who set it up as it links to a rubyforge account set up by you back in 2007.

Any ideas? If you are the one, you can update it (if it requires login, not too sure) ... if not there's a message at the top of the page which says;

If we've got your group details wrong, please berate us at [email protected]

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.