0
Fork 0
mirror of https://github.com/verdaccio/verdaccio.git synced 2024-12-16 21:56:25 -05:00
verdaccio/docs/contributing.md
2018-01-20 23:00:45 +01:00

21 KiB

id title
contributing Contributing Verdaccio

First of all 👏👏 thanks for visiting this page, for us means you are willing contribute to verdaccio and we are happy for that. Jumping into an unfamiliar code base is not easy but we are here to help you.

Comunication Channels

If you are willing for asking, we use two channels for discussions:

Getting started

As a first glance verdaccio is a single repository, but there are many ways you might contribute and a variety of technologies to practice.

Finding my spot

All we have different skills, so, let's see where you might feel comfortable.

I know or I want to learn Node.js

Node.js is the base of verdaccio, we use libraries as express, commander, request or async. Verdaccio is basically a Rest API that create a communication with npm clients compatible, as yarn.

We have a long list of plugins ready to be used and improved but at the same time you might create your own.

I would prefer to work in the User Interface

Recently we have moved to modern techonologies as React and element-react. We are looking forward to see new ideas how to improve the UI.

I feel more confortable improving the stack

Of course, we will be happy to help us improving the stack, you can upgrade dependencies as eslint, stylelint, webpack. You migt merely improve the webpack configuration would be great. Any suggestion is very welcome. Furthermore whether you have experience with Yeoman you might help us with the verdaccio generator.

Here some ideas:

  • Create a common eslint rules to be used across all dependencies or plugins
  • Improve Flow types definitions delivery
  • Moving to Webpack 4
  • Improve hot reload with Webpack
  • We use babel and webpack across all dependencies, why not a common preset?
  • Improve continous integration delivery

I do great Documentation

Many contributors find typos and grammar issues, that also helps to improve the overall experience for troubleshooting.

I am a Designer

We have a frontend website http://www.verdaccio.org/ that will be happy to see your ideas.

Our website is based on Docusaurus.

I am a DevOps

We have a widely popular Docker image https://hub.docker.com/r/verdaccio/verdaccio/ that need maintenance and pretty likely huge improvements, we need your knowledge for the benefits of all users.

We have support for Kubernetes, Puppet, Ansible and Chef and we need help in those fields, feel free to see all repositories.

I can do translations

Verdaccio aims to be multilingual, in order to achieve it we have the awesome support of Crowdin that is an amazing platform for translations.

We have setup a project where you can choose your favourite language, if you do not find your language feel free to request one creating a ticket.

Go to Crowdin Verdaccio

I'm ready to contribute

If you are thinking "I've seen already the repositories and I'm willing to start right away" then I have good news for you, that's the next step.

You will need learn how to build, we have prepared a guide just for that.

Once you have played around with all scripts and you know how to use them, we are ready to go to the next step, run the Unit Test.

Full list of contributors. We want to see your face here !

juanpicado rlidwka Meeeeow trentearl ayusharma
juanpicado rlidwka Meeeeow trentearl ayusharma
verdacciobot jmwilkinson UnitedMarsupials ryan-codingintrigue ramonornela
verdacciobot jmwilkinson UnitedMarsupials ryan-codingintrigue ramonornela
renovate-bot rodriguesbreno vernak2539 jachstet-sea lgaitan
renovate-bot rodriguesbreno vernak2539 jachstet-sea lgaitan
crispy1989 neuquino markpeterfejes steve-p-com BartDubois
crispy1989 neuquino markpeterfejes steve-p-com BartDubois
karfau 030 Qwerios wiggisser kfatehi
karfau 030 Qwerios wiggisser kfatehi
imsnif denisbabineau HCanber jgoz josephg
imsnif denisbabineau HCanber jgoz josephg
kba aledbf drubin plitex nedelenbos
kba aledbf drubin plitex nedelenbos
mysiar bufferoverflow osher danielo515 marnel
mysiar bufferoverflow osher danielo515 marnel
aszmyd estliberitas Alexandre-io amirmohsen BarthV
aszmyd estliberitas Alexandre-io amirmohsen BarthV
BogdanAlexandru iambrandonn robi-wan crohrer psychocode
BogdanAlexandru iambrandonn robi-wan crohrer psychocode
conorhastings coreyjewett dbroadhurst etiennetremel einfallstoll
conorhastings coreyjewett dbroadhurst etiennetremel einfallstoll
gempain lbguilherme gecruz idangozlan jrussellsmyth
gempain lbguilherme gecruz idangozlan jrussellsmyth
jirutka kingjan1999 vStone zaventh jeremymoritz
jirutka kingjan1999 vStone zaventh jeremymoritz
jondlm speier kodypeterson mrblackus metaa
jondlm speier kodypeterson mrblackus metaa
bajtos okv Vrtak-CZ rafacesar rbpinheiro
bajtos okv Vrtak-CZ rafacesar rbpinheiro
r3wald robertgroh prssn RodrigoBalest RomainLK
r3wald robertgroh prssn RodrigoBalest RomainLK
rmg samcday tarun1793 tcort grrowl
rmg samcday tarun1793 tcort grrowl
tlvince lordvlad wpasternak yannickcr yannickglt
tlvince lordvlad wpasternak yannickcr yannickglt
silkentrance jjaakola maxlaverse ChadKillingsworth
silkentrance jjaakola maxlaverse ChadKillingsworth