Iran Open Source Hackathon is an open-source hackathon (duh) with the aim of encouraging participation in open-source contribution amongst Iranian developers. There is a curated list of repositories whose maintainers volunteered to be part of the hackathon. Contribute to any of these repositories during the hackathon, and at the end top contributors will be acknowledged here (so yes in the end its just about bragging rights).
👉 If you are a maintainer and want to enter some of your repositories in the hackathon so our participants will contribute to them, check this section.
A Note on Terminology
In these documents, keywords MUST, MUST NOT, REQUIRED, SHALL, SHALL NOT, SHOULD, SHOULD NOT, RECOMMENDED, MAY, and OPTIONAL, when appearing in caps lock and in bold, are to be interpreted as described in RFC 2119. This is not a software spec document, but still the extra clarity helps avoiding confusion.
⚠️ ⚠️ WORK IN PROGRESS NOTICE
This is work in progress. As long as this notice is up here, any rule, date, information, etc is subject to sudden change without any prior notice.
If a piece of information is followed by
⚠️
, then there is a good chance we will change it in near future and current information is mostly a placeholder.
Contribute to one of these repositories during the time of the hackathon:
- Make a pull request, include #iosh
⚠️ in its title⚠️ . - The pull request MUST be accepted to the repository before the end of the hackathon.
- Each pull request will count towards your total score (depends on how many lines of code it is
⚠️ ). - At the end, top 5
⚠️ contributors (highest scores⚠️ ) will be acknowledged here. We might update the list during the hackathon as well.
👉 If you are unfamiliar with open-source contribution, git or github, take a look at these resources.
NOTE: Please carefully read our code of conduct before you start contributing.
- You will help improve software that people like you use (apes together strong).
- You will learn a lot (like seriously, a TON).
- You will earn street-cred (which also helps with employability).
Of course! You need to:
- Fork this repository.
- For each repository like
https://github.com/jafar/my-repo
, add a yaml file tofirst/repos
(i.e.first/repos/jafar/my-repo.yaml
):
# first/repos/jafar/my-repo.yaml
name: My Cool Repository
description: I am particularly cool here
languages:
- JavaScript
- Hashemi
- ...
- Make a pull request.
👉 You can see examples in the repos directory.
👉 You can add a list of maintainers (with whom hackathon participants can be in contact) as well:
# first/repos/jafar/my-repo.yaml
name: My Cool Repository
description: I am particularly cool here
languages:
- JavaScript
- Hashemi
#
# 👉 for user `https://github.com/asghar`, add `asghar` to this list
# 👉 also don't forget the repo owner if they are going to be a maintainer as well
#
maintainers:
- jafar
- asghar
- nooshin
- maliheh
👉 If your repo belongs to a company, you MUST specify maintainers independently.
NOTE: Please carefully read our code of conduct before you submit your repositories.
Name | Description | Owner | Maintainer(s) | Languages |
---|---|---|---|---|
Letiner | An intelligent Leitner to memorize information, especially words, without needing to maintain boxes manually. It can be synced with Dropbox. | justmisam | justmisam | Javascript, HTML, CSS |
Lightweight Message Queue (LMQ) | A lightweight message queue to work with short messages or content references as messages. | justmisam | justmisam | Go |
PyLMQ | Python Library for LMQ | justmisam | justmisam | Python |
BarnameKon | Telegram bot which create "Add to Google Calendar" link for your events. | anvaari | anvaari | python |
TyFON | Typed Functions Over Network | loreanvictor | loreanvictor | typescript, javascript |
Callbag JSX | callbags + JSX: fast and tiny interactive web apps | loreanvictor | loreanvictor | typescript |
divar-starter-kit | React.js SSR-ready boilerplate using Razzle. | divar-ir | iMohammadReza | javascript |
gRPC Go Contracts | Verify the communication of your microservices by writing contracts for your RPCs | shayanh | shayanh | go |
thatcher-effect-dataset-generator | Using OpenCV to apply Thatcher effect on a set of face images | erfaniaa | erfaniaa | Python |
text-to-commit-history | Write a large text on your Github profile, with your commits history (contribution graph). | erfaniaa | erfaniaa | Python |
Keepalived Exporter | Prometheus exporter for Keepalived metrics. | cafebazaar | mehdy | go |
Anbar | A basic S3 compatible storage server in Rust. | mehdy | mehdy | rust |
Pyeez | A simple framework to create console applications (like htop). | mehdy | mehdy | python |
paperify | Backup files on paper using QRCodes. | alisinabh | alisinabh | shell |
To be completed
Beginning | تیر ۱۵ | 06 July |
---|---|---|
Ending | شهریور ۱۵ | 06 September |
۱۴۰۰ / 2021
Your pull requests MUST be submitted after beginning of the hackathon period and be merged before the end of the hackathon.
Ideally, submit your repositories before the start of the hackathon, though you can (
To be determined