start lesson contribution draft

Author: samumantha

contributing.md

@@ -75,6 +75,11 @@ Soon, you will wonder why you ever bothered teaching alone.
 
 Read more: {doc}`open-your-courses`
 
+## Lesson contribution
+
+All our lessons are hosted on GitHub. You can find the link to the GitHub repositories from the respective lesson page ([lesson links on our webpage](https://coderefinery.org/lessons/#lessons-that-we-teach-in-our-tools-workshops)) on the top right corner -> "Edit on GitHub". 
+
+Please refer to our lesson contribution page for guides and support: {ref}`contribute` .
 
 
 ## Other types of contributions

lesson-contribution.md

@@ -6,12 +6,30 @@ Also read {ref}`design` and {ref}`review`.
 
 This document is work in progress on how to contribute to a CodeRefinery lesson. 
 
+We use GitHub issues to communicate things that need to be updated, collect feedback and improvement suggestions. 
+Latest prior to every workshop we go through the issues and implement and resolve at least the urgent ones. 
+
+All our lesson materials are written in Markdown using our own [Sphinx lesson theme and template]().
+
+Improvements are done on branches either on the CodeRefinery repository or your own fork. The improvement suggestions are then submitted via Pull Requests.
+For easier and faster review, please keep the pull requests topically small. 
+
+Steps to contribute to a CodeRefinery lesson: 
+
 1. Find the lesson materials on GitHub
 2. Submit an issue describing the things you would like to fix / update / add
 3. Discuss with the team in the issue
 4. Work on your own fork and branch on the implementation
 4a. Add yourself as author to the citation.cff file
 5. Submit a draft Pull Request if you want early comments and discussion
-6. Submit a pull request to the lesson repository
+6. Build the lesson locally to check the format
+6. Submit a pull request to the lesson repository with coderefinery-team as reviewer
 7. Remind the team in chat or via support@coderefinery.org if you do not get any comments or reviews within some days. 
 
+## Lesson preview
+
+Preview lesson page by building it locally using Sphinx: XX 
+
+## Creating a CodeRefinery lesson
+
+Creating your own lesson from scratch: XX