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

[#1]

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 "[email protected]"

• Subscribed to the Freescale Yocto Project Mailing List

• 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 [email protected] <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>