The project aims to build a platform for African Ruby language enthusiasts to connect, share their knowledge and experience, collaborate on projects, and stay up-to-date with the latest developments in the Ruby community, whether they are seasoned developers or beginners just starting out. The platform features a variety of resources, including different chapters for different countries and cities, merchandise, and meetup information. It will also help users get information on online workshops, webinars, and meetups organized by the community, enabling them to learn from experts and network with other enthusiasts.
Project Design: https://still-snowflake-8822.animaapp.io/
Database Design: https://dbdiagram.io/d/62afab7c9921fe2a96397c1e
N.B. Please note that this project is open source, you are therefore encourage to contribute
- RVM is a command-line tool that allows you to easily install, manage, and work with multiple Ruby environments, including interpreters and sets of gems. It supports both UNIX-like systems and Windows (with Cygwin or Bash on Ubuntu on Windows).
Run the following in the terminal or CMD (on Windows)
$ \curl -sSL https://get.rvm.io | bash -s stable
-
Restart the terminal or cmd and run command below to check if rvm is installed.
$ rvm list
$ rvm install <ruby version>
- e.g. Ruby Version 3.0.2
Since Rails is a gem, which is a standardized format that contains Ruby programs, you can also install various versions of Rails by using the gem
command
$ gem install rails -v <rails specified version>
- e.g. Rails Version 7.0.3
NB: For more installation details, checkout Installing RVM documentation on the same.
- rbenv is a version control tool for Ruby. It helps you switch between different Ruby versions and make sure that every project you are working on always operates independently on the designated version.
You can choose the Ruby version for your project with, for example:
cd myproject
# choose Ruby version 3.0.2:
rbenv local 3.0.2
On systems with Homebrew package manager, the “Using Package Managers” method is recommended. On other systems, “Git Checkout” might be the easiest way of ensuring that you are always installing the latest version of rbenv.
-
Install rbenv using one of the following approaches.
On macOS or Linux, we recommend installing rbenv with Homebrew.
$ brew install rbenv ruby-build
Note that the version of rbenv that is packaged and maintained in the Debian and Ubuntu repositories is out of date. To install the latest version, it is recommended to install rbenv using git.
$ sudo apt install rbenv
Archlinux has an AUR Package for rbenv and you can install it from the AUR using the instructions from this wiki page.
-
Load rbenv in your shell.
# run this and follow the printed instructions: $ rbenv init
-
Restart your terminal so your changes take effect.
That's it! You are now ready to install different ruby versions.
-
Clone rbenv into
~/.rbenv
.$ git clone https://github.com/rbenv/rbenv.git ~/.rbenv
-
Configure your shell to load rbenv:
-
For bash:
Ubuntu Desktop users should configure
~/.bashrc
:$ echo 'eval "$(~/.rbenv/bin/rbenv init - bash)"' >> ~/.bashrc
On other platforms, bash is usually configured via
~/.bash_profile
:$ echo 'eval "$(~/.rbenv/bin/rbenv init - bash)"' >> ~/.bash_profile
-
For Zsh:
echo 'eval "$(~/.rbenv/bin/rbenv init - zsh)"' >> ~/.zshrc
-
-
Restart your shell so that these changes take effect.
Before attempting to install Ruby, check that your build environment has the necessary tools and libraries. Then:
# list latest stable versions:
rbenv install -l
# list all local versions:
rbenv install -L
# install a Ruby version:
rbenv install 3.0.2
All done!
You are now free to proceed to the steps below:
- Create a fork of this repository from main branch
- Select an issue to work on from the main repository
- Create a branch name to match the selected issue from the main branch
NB:
- Always make sure your fork is in sync with the main
- All changes you make for the issue will be on this branch
Run the following command in the terminal
$ git clone <link to you forked repo>
$ cd <path to your cloned repo>
$ bundle install
$ rails db:create
$ rails db:migrate
yarn install
./bin/dev
- make changes locally on your branch
- push your changes to your branch on github
- create a pull request to main branch of the main repository
Once your changes are reviewed they will be merged to the main branch
Thank you for your interest in contributing to the Africa Ruby Community (ARC) Platform! We welcome contributions from developers of all experience levels.
We label our issues to help contributors find ones that match their skills and experience level. Here are some labels you might find helpful:
To guide people in searching for issues using these labels, you can provide the following steps:
- Go to the project's repository on GitHub.
- Click on the
Issues
tab. - Use the search bar at the top to search for issues using one or more of the labels listed above.
- You can refine your search by adding additional keywords or filters, such as language, platform, or component.
- Once you find an issue you are interested in working on, read through the description and comments to get a better understanding of the problem and any suggested solutions.
- If you have any questions or need help, leave a comment on the issue and wait for feedback from other contributors or maintainers.
NB: The section below outlines how the README should be written
This README would normally document whatever steps are necessary to get the application up and running. (guide)
Things you may want to cover:
-
Ruby version
-
System dependencies
-
Configuration
-
Database creation
-
Database initialization
-
How to run the test suite
-
Services (job queues, cache servers, search engines, etc.)
-
Deployment instructions
-
...