diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5410d0d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,32 @@
+
+<!--Your Github repository must have the following contents:
+
+    A README.md file that communicates the libraries used, the motivation for the project, the files in the repository with a small description of each, a summary of the results of the analysis, and necessary acknowledgments.
+
+    Your code in a Jupyter notebook, with appropriate comments, analysis, and documentation.
+
+    You may also provide any other necessary documentation you find necessary.-->
+
+# stacksurvey
+
+**stacksurvey** is an exploration and analysis of data from StackOverflow's developer survey of 2024.
+
+[https://survey.stackoverflow.co/2024/](https://survey.stackoverflow.co/2024/)
+
+The motivation for project is satisfying a class assignment. Eventually, an interesting (enough) topic was discovered in the data set: 
+
+What is the annual compensation (y) over years of experience (x) of deveopers who use a programming language from a specific country?
+
+## Requirements
+
+    numpy pandas sklearn matplotlib seaborn
+
+## Summary of Analysis
+
+*For the purpose of this analysis, (data) scientists and researchers are also considered developers.*
+
+The models generated by the notebook become less reliable for incomes greater than $200,000 per year and years of experience after 10.
+
+![graph of c programmers](images/programmers-C-United-States-of-America.png)
+
+![graph of python programmers](images/programmers-Python-United-States-of-America.png)
diff --git a/images/programmers-C-United-States-of-America.png b/images/programmers-C-United-States-of-America.png
new file mode 100644
index 0000000..1cbdf3d
Binary files /dev/null and b/images/programmers-C-United-States-of-America.png differ
diff --git a/images/programmers-Python-United-States-of-America.png b/images/programmers-Python-United-States-of-America.png
new file mode 100644
index 0000000..b252aa1
Binary files /dev/null and b/images/programmers-Python-United-States-of-America.png differ