add steps

Author: Hörmet Yiltiz

CONTRIBUTING.md

@@ -13,4 +13,44 @@
 * Ensure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.
 * Changes that do not add anything substantial to the stability, functionality, or testability will generally not be accepted.
 
+### Steps
+
+- Set up the paprent repo which provides dev environment and exposes Python APIs:
+
+        git clone --recursive https://github.com/albertlauncher/albert.git
+        cd albert
+        cmake -B build -S . -DCMAKE_INSTALL_PREFIX=~/.local/ -DCMAKE_BUILD_TYPE=Debug
+        cmake --build build
+        cmake --install build
+
+- The above also clones Albert python plugins repo as a git submodule under `albert/plugins/python/plugins/`. Refer to the (official API)[https://albertlauncher.github.io/reference/namespacealbert.html] for the class definitions. Read the stub file `plugins/python/albert.pyi` which describes the classes commonly used in albert python plugins; this file also provides completion and type hints for your editor/IDE.
+
+- Fork the official albert python plugins repo in Github web page: https://github.com/albertlauncher/python. Then create your new plugin folder following:
+
+        cd albert/plugins/python/plugins/
+        git add remote mine https://github.com/<github-handle>/albert-plugins-python
+        mkdir my_plugin
+        cat <<EOF > __init__.py
+        import albert
+
+        md_iid = '2.4'
+        md_version = '1.0'
+        md_name = 'My Plugin'
+        md_description = 'Does fancy things'
+
+        class Plugin(albert.PluginInstance):
+            pass
+        EOF
+        python3 -m venv .venv
+        source .venv/bin/activate
+
+- Go to the root repo `albert` containing `pyproject.Test your project to ensure it works.
+
+- Rename your project to better describe it. Once you are finished, create a pull request:
+
+        git add my_awesome_new_plugin
+        git commit
+        git push mine main
+        # now go to your Github fork page to create a PR to the Albert python plugins repo
+
 Thanks! :heart: