diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b70f87f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,89 @@
+# simple_blog
+
+simple_blog is a basic blogging platform. It is designed to be a straightforward way to publish articles written in Markdown and display them using a renderer written in PHP. There is no login page or any way to manage simple_blog from the web. All management is done via the command line. This can be done with a shell script or with the python based [simple_blog_cms](https://20xd6.net/git/20xd6/simple_blog_cms). 
+
+## Requirements
+
+* Currently tested with PHP 7.4
+* Some shell access is necessary.
+    * The recommend way is via ssh.
+    * I don't see a technical reason it can't work with a web manager like cPannel or Ajenti as long has you have the ability to upload files and manage files.
+
+## Publishing
+
+## Description
+
+### blog
+
+Contains the blog articles. The articles are placed in subdirectories of `by_year` according to the month they were published. 
+
+### common
+
+This directory contains the files and libraries used to render the site's pages.
+
+#### Composer files
+* composer.json
+* composer.lock
+* [/common/vendor]() - Stores the composer files and libraries managed via composer.
+
+#### CSS
+
+* [styles.css](src/branch/master/common/styles.css) - The main site CSS.
+* [jmenu.css]() - Used to render the responsive menus.
+* [print.css]() - Used to style printed pages.
+* [gallery.css]() - Styles the floating 
+
+#### JS
+
+* font_size.js
+* page_format.js - The main 
+* gallery.js
+
+#### PHP
+
+* [footer.php]()
+* [get_month_name.php]()
+* [h1_month.php]()
+* [header.php]()
+* [index.php]()
+* [markdown.php]()
+* [md_read.php]()
+* [menu.php]()
+* [modal.php]()
+* [page_menu.php]()
+* [page_menu_table.php]()
+* [path_menu.php]()
+
+#### /common/error_pages/
+
+* /common/403.php
+* /common/404.php
+* /common/500.php
+
+#### /common/imgs/
+
+Images used site wide.
+
+* [cursor.gif]() - Blinking cursor used on the front page.
+* [icon-rss.png]() - RSS icon
+
+
+#### /common/prisim 
+
+Files for the prism syntax highlighter.
+
+### license
+
+This directory contains all the licensing information for simple_blog. simple_blog is licensed under the GPLv2 but uses components that are licensed under the MIT Open Source license. These components are 
+
+#### index.php
+
+Displays all of the reverent license and the components they apply to.
+
+* simple_blog is licensed GPLv2. This cannot be changed.
+* Default license for articles published. This is [Creative Commons Attribution 3.0 Unported License](http://creativecommons.org/licenses/by/3.0/) by default. This licensed can be changed however the site admin wishes.
+* [Jmenu](https://github.com/jamesjohnson280/JMenu) is licensed MIT. This cannot be changed.
+* [Parsedown](https://github.com/erusev/parsedown) is licensed MIT. This cannot be changed.
+* [Parsedown-extra](https://github.com/erusev/parsedown-extra) is licensed MIT. This cannot be changed.
+
+Copies of all these licenses can be found in the `/license/` directory.
\ No newline at end of file