Final Submission: Fuzzing Executable Tutorial

contributions/executable-tutorial/palagi-civjan/README.md

@@ -2,7 +2,7 @@
 
 ## Title
 
-Integrating OSS-Fuzz into Go project to demonstrate debugging with modern fuzzing techniques
+Katacoda Executable Tutorial demonstrating and explaining Fuzzing
 
 ## Names and KTH ID
   - Brad Palagi ([email protected])
@@ -20,6 +20,35 @@ Executable Tutorial
 
 Fuzz testing is an essential topic for testing and security. 
 
-We will create a browser based jupyter-notebook with the goal of teaching the user how to effectively use OSS-Fuzz to debug a Go project.
+We created a Katacoda Scenario with the goal of teaching the user how to effectively use Atheris, Google's Python Fuzzing tool which is a part of OSS-Fuzz and can be integrated into ones own git repository using ClusterFuzzLite.
 
-In our tutorial we will include descriptions of what **fuzzing** is as a debugging technique as well as show how OSS-Fuzz can be used in practice to create a CI-based fuzz testing development cycle.
+In the tutorial we covered: Background information on fuzzing as a testing technique, the Pros and Cons of Fuzzing versus standard or other testing methods, how to integrate Google's Atheris Python fuzzer with a Python program, and how to add this type of fuzzing into a CI workflow with GitHub Actions using ClusterFuzzLite.
+
+Final Submission Links:
+
+Katacoda-Scenario Repository: https://github.com/bencivjan/katacoda-scenarios <br />
+Katacoda-Scenario Tutorial: https://www.katacoda.com/bencivjan/scenarios/fuzzing-exec-tutorial
+
+Fuzzing Workflow Flowchart: <br />
+![Image](FuzzFlowChartV1.jpg)
+
+
+<br />
+<br />
+<br />
+
+**Grading Criteria We Intended To Meet**
+
+|                                             | Yes | No | 
+|-------------------------------------------- | ----|----|
+|executable: The tutorial can be automatically executed from beginning to the end, in the browser or in CI (see below) | **Mandatory** | - | 
+|ilo: The tutorial states the intended learning outcomes. | **Mandatory** | - | 
+|motivation: The tutorial is clearly motivated (why it matters for Devops?) | **Yes** | No | 
+|browser-based: The tutorial can be successful executed in the browser (katacoda is recommended) | **Yes** | No | 
+|ci-based: The tutorial can successful be executed as a CI job | *Yes* | No | 
+|background: The tutorial gives enough background | **Yes** | No | 
+|illustrated: The tutorial is illustrated with an informative figure (eg a flowchart) | *Yes* | No | 
+|pedagogical: The tutorial is easy to follow  | **Yes** | No | 
+|original: The tutorial is original, no or few similar tutorials exist on the web | **Yes** | No |
+|easter-eggs: The tutorial contains an easter egg | *Yes* | No | 
+|language: The language is appropriate (structure, grammar, spelling) | **Yes** | No |