add documentation

2 files changed, 24 insertions, 0 deletions

diff --git a/doc/FAQ b/doc/FAQ
new file mode 100644
index 0000000..bfc6eac
--- /dev/null
+++ b/doc/FAQ
@@ -0,0 +1,16 @@
+Frequently Asked Questions
+==========================
+
+Why OpenGL and not X?
+---------------------
+
+(Where X = Vulkan, Metal, DirectX, etc.)
+
+Because it's so widespread and common that I can take its support for granted.
+
+Why FreeGLUT and not X?
+-----------------------
+
+(Where X = GLFW, SDL, etc.)
+
+Because it has and does exactly what I need. Other libraries handle a lot of other things that I don't need (e.g. audio), which translates into avoidable downsides.
diff --git a/doc/README b/doc/README
new file mode 100644
index 0000000..8b60404
--- /dev/null
+++ b/doc/README
@@ -0,0 +1,8 @@
+Documentation
+=============
+
+In this directory you'll find pretty much all the documentation that needs to 
+be provided in addition to what the code and its comments tell already.
+
+If you have a question, head to FAQ.
+