diff --git a/README.md b/README.md
new file mode 100644
index 0000000..46b8c0f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# Tanks
+Set 3 AP computer science programming project
+This was a project created for the prupose of illistrating several features in Java. It can be run through any compiler through standard 
+practices.
+
+To contribute:
+The main class, Tanks, is outdated cold use some effiency increases. The code and logic is long and could easily be improved.
+In addition, the program has limited funciontality. after a certain level, the game just ends. this level could be increased to add difficulty.