Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
129 lines (115 loc) · 7.8 KB

CONTRIBUTING.md

File metadata and controls

129 lines (115 loc) · 7.8 KB

CONTRIBUTING

Table of Contents

Basic template to fill up an issue and/or a new file.md is:

# title
	ref to file.md or #issue :
	## contexte
	## objectif
	## proposition
	## inspirations

# protocol
	## time 
	## skills
	## Resources
	## How To
	## Result

Why to contribute?

Why do people contribute to open source? Plenty of reasons!

  • Improve existing skills
    Whether it’s coding, user interface design, graphic design, writing, or organizing, if you’re looking for practice, there’s a task for you on an open source project.
  • Meet people who are interested in similar things
    Open source projects with warm, welcoming communities keep people coming back for years. Many people form lifelong friendships through their participation in open source, whether it’s running into each other at conferences or late night online chats about burritos.
  • Find mentors and teach others
    Working with others on a shared project means you’ll have to explain how you do things, as well as ask other people for help. The acts of learning and teaching can be a fulfilling activity for everyone involved.
  • Build public artifacts that help you grow a reputation (and a career)
    By definition, all of your open source work is public, which means you get free examples to take anywhere as a demonstration of what you can do.
  • Learn people skills
    Open source offers opportunities to practice leadership and management skills, such as resolving conflicts, organizing teams of people, and prioritizing work.
  • It’s empowering to be able to make changes, even small ones
    You don’t have to become a lifelong contributor to enjoy participating in open source. Have you ever seen a typo on a website, and wished someone would fix it? On an open source project, you can do just that. Open source helps people feel agency over their lives and how they experience the world, and that in itself is gratifying.
    source: https://opensource.guide/how-to-contribute/

On what to contribute?

  • You don’t have to contribute code
    A common misconception about contributing to open source is that you need to contribute code. In fact, it’s often the other parts of a project that are most neglected or overlooked.

  • Do you like planning events?

  • Do you like to design?

  • Do you like to write?

  • Do you like organizing?

  • Do you like to code?

  • Do you like helping people?

  • Do you like helping others code?

You don’t just have to work on software projects!

source: https://opensource.guide/how-to-contribute/#what-it-means-to-contribute

Actuellement, j'ai fait une liste des grands sujets et tâches en cours dont je m'occupe et j'aimerai arriver à réunir des teams avec ceux qui peuvent m'aider sur un sujet précis.

  • Gala OF, présentation Openfab #community
    Pour le 10 fev donc,
  • Aménagement local #community
    • Fabrication d'une table pour la découpeuse laser et réaménagement global du local.
    • Faut réorganiser les boites, les stocks, la circulation, fabriquer quelques meubles qui manquent et un espace admin/bureau, etc...
  • Structure et administration Asbl #community
    ça suivra la présentation avec l'aide du nouveau CA mais en attendant faut encore éviter de faire des bétises.
  • Gamification, level Up #community
    Stratégie d'évolution des membres dans Openfab.
    • Faut continuer de structurer
    • "codifier" les règles du jeu.
    • Créer le contenu manquant et tester. (passeport et badges par exemple)
    • Accueil des gens au lab #community
      Et bien sur, il y a tjs des nouveaux qui arrivent. Faut les accueillir et arriver à les embarquer dans le jeu.
  • Aventutoriaux #community
    Création de livres dont tu es le héro mais dédié au fablab. Sert de support pour ceux qui veulent faire mais qui n'ont pas de projet clair à faire (trop de choix, tue le choix). Un storytelling qui guide l'utilisateur au travers de tutoriels qui couvrent les techniques disponibles au fablab. Le logiciel opensource Twine aidera à l'écriture du contenu non linéaire. https://twinery.org/
    exemple: http://www.louisrakovich.com/files/theme/afiredarklyi.html
  • Chic2.0 #services
    • Prochain workshop le 28,29,30 Mars puis un second fin Mai. Organisation, préparation et suivit sont à faire. J'aimerai faire participer les différentes personnes ayant participé ou qui vont participer, pour de l'aide mais aussi dans un soucis de continuité durant l'ensemble des workshops.
    • Il faut aussi documenter les workshops de BCN
    • StDenis de 2016,
    • partager les fichiers sources
  • Nouveau site web, nouvelle architecture WP3 et lien avec miniSite github #community
    La com qui met en lien les différents sujets et qui va faire le support entre eux. (mini.site Chic, mini.site Aventutoriaux, mini.site projets, etc...
    J'ébauche juste la compréhension de structure des pages dans github sur mon compte perso
  • CQD artisan2.0 #services
    C'est l'appel à projet remporté l'été dernier. On vient de recevoir les sous. l'objectif est d'organiser 2 bricole&picole (intro, outro) et 10 j de stage répartis comme on veut d'ici fin 2017. La thématique est de montrer ce qu'apporte les démarches numériques associée à l'artisanat traditionnel.
    • Bricole & picole 1
    • Dewi et Anne-sophie workshop Juillet/Aout
    • Design september, teaser workshop
    • 6 sessions Octobre
    • 1 session Novembre
    • Bricole & Picole 2
  • Fabcity #community
    Développement du réseau BXL de maker, vision macro locale et Fabcity Vault.
  • Les jobs, Quentin, stoemelings, poolpio, #services
    Tout ce bazar amène quand même quelques commandes et des jobs à réaliser. $$
  • Valorisation des projets #services
    Comment valoriser ces réalisations, ces jobs pour en attirer d'autres. Nouveaux projets, nouvelles commandes, des sous pour la popoche. + de $$
    • Création d'un catalogue des produits, services et workshop que l'on peut proposer.
  • Documentation des projets, des processus #community Et pour commencer, baliser et documenter les processus de documentation

C'est déjà pas mal. Quand je pense qu'il y a des gens qui s'ennuient....

How to contribute?

Boucle 1

Issue > fichier.md > reward

Naming convention

Avoid

Les caractères suivants sont réservés pour des usages spéciaux et ne doivent pas être utilisés dans le nom lui-même :

< (plus petit que; less than)
> (plus grand que; greater than)
: (deux points; colon)
" (double appostrophe; double quote)
/ (slash; barre de fraction; forward slash)
\ (back slash)
| (barre verticale; vertical bar; pipe)
? (point d'interrogation; question mark)
* (astérisque; asterisk)

Use

  1. use lower case.
  2. use dashes.
  3. be specific. you may find you have to differentiate between similar ideas later
  4. be consistent.

Exemple:

is-there-a-naming-convention-for-git-repositories.md