i.MX Yocto Project: How can I contribute to the community?

Document created by Leonardo Sandoval Gonzalez Employee on Jul 30, 2013
Version 1Show Document
  • View in full screen mode

The Yocto Project is open-source, so anyone can contribute. No matter what your contribution is (bug fixing or new metadata), contributions are sent through patches to a community list. Many eyes will look into your patch and at some point it is either rejected or accepted. Follow these steps to contribute:

 

 

  • Make sure you have previously configured your personal info

 

$ git config --global user.name "Your Name Here"

$ git config --global user.email "your_email@example.com"

 

 

  • Download `master` branches

 

fsl-community-bsp $ repo init \

  -u https://github.com/Freescale/fsl-community-bsp-platform \

  -b master

 

  • Update

 

fsl-community-bsp $ repo sync

 

 

Create local branches so your work is *not* done on master

 

fsl-community-bsp $ repo start <branch name> --all

 

Where `<branch name>` is any name you want to give to your local branch (e.g. `fix_uboot_recipe`, `new_gstreamer_recipe`, etc.)

 

  • Make your changes in any Freescale related folder (e.g. sources/meta-fsl-arm). In case you modified a recipe (.bb) or include (.inc) file, do not forget to *bump* (increase the

value by one) either the `PR` or `INC_PR` value

 

  • Commit your changes using `git`. In this example we assume your change is on `meta-fsl-arm` folder

 

sources/meta-fsl-arm $ git add <file 1> <file 2>

sources/meta-fsl-arm $ git commit

 

On the commit's log, the title must start with the filename change or introduced, then a brief description of the patch's goal, following with a long description. Make sure you follow the standards

(type ` git log --pretty=oneline` to see previous commits)

 

  • Create a patch

 

sources/meta-fsl-arm $ git format-patch -s  --subject-prefix='<meta-fsl-arm][PATCH' -1

 

Where the last parameter (`-1`) indicate to patch last commit. In case you want to create patches for older commits, just indicate the correct index.

If your patch is done in other folder, just make sure you change the `--subject-prefix` value.

 

  • Send your patch or patches with

 

git send-email --to meta-freescale@yoctoproject.org <patch>

 

 

where `<patch>` is the file created by `git format-patch`.

 

  • Keep track of patch's responses on the mailing list. In case you need to rework your patch, repeat the steps but this time the patch's subject changes to `--subject-prefix='<meta-fsl-*][PATCH v2'`

 

  • Once your patch has been approved, you can delete your working branches

 

fsl-community-bsp $ repo abandon <branch name>

Attachments

    Outcomes