add readme

fix format on translations.md

Author: camthegeek

README.md

@@ -0,0 +1,27 @@
+# Official Masari Project Website
+
+![travis build status](https://travis-ci.org/masari-project/masari-project.github.io.svg?branch=development)
+
+Visit the Official Masari Project Website at [https://getmasari.org](https://getmasari.org). 
+
+The Masari Project website is 100% open source and is available for any one to edit. Basic knowledge of HTML, CSS, Markdown and Jekyll may be needed.
+
+To make changes, simply fork our repository, create a new branch based on our `development` branch and then submit a Pull Request with the changes. 
+
+## Building locally
+
+To build the Masari Project website on your local system, you will need to set up [Jekyll](https://jekyllrb.com/). As Jekyll as other requirements, we suggest that you follow publicly available guides to set up Jekyll on your desired system. 
+
+## Site Translations
+
+We encourage any one who can translate from English to their native language to please do so. For instructions on translating the Masari Project website, please refer to [our translations readme](TRANSLATIONS.md).
+
+## Site Issues
+
+Are you experiencing a viewing issue on the website? We encourage you to open an [issue](https://github.com/masari-project/masari-project.github.io/issues/new). For more immediate assistance, visit us on [Discord](https://discord.gg/sMCwMqs) and make your statement in the #development channel.
+
+### Kudos
+- @camthegeek - new website
+- @jeutheidit - Content writer
+- @xiaomogwai - Testing on Mac 
+- Kudos to many others for testing and providing feedback!

TRANSLATIONS.md

@@ -1,17 +1,20 @@
-**Translating the Masari website**
+# Translating the Masari Project website
 
 English is the primary language across multiple projects worldwide. All translations should be based upon their English version.
 
-***First Step***
+## First Step
+
 The first file you should focus on translating will be located here:
 - _i18n/en.yml
 
 Copy this file and rename it to your desired language code. Example: fr.yml would be great for French translation. In this file, be sure to add your language code and full language name under `Language:`.
 
-*** Second Step ***
+## Second Step
+
 The next step is to add your language to the site configuration file. This is located in the main directory and is titled `_config.yml`. Find the area in `_config.yml` that contains `languages:`. Add your language. Example: `languages: ["en", "fr"]`. Each language will be wrapped in quotes and will be seperated by commas.
 
-*** Third Step ***
+## Third Step
+
 The Masari website was designed and developed to have sections that can easily be edited, updated, removed and translated in an organized manner. This allows us to have a more flexible content website. 
 
 The following files should also be translated. These files contain content for the RESEARCH CORNER, RESOURCES and ROADMAP sections. The content in DOWNLOADS should be fine as is. In the RESOURCES file, only the name field will need to be translated.
@@ -41,9 +44,13 @@ The following files should also be translated. These files contain content for t
 
 After translating the above files, the majority of the front page content should be translated.
 
-*** Fourth Step ***
+## Fourth Step 
 Now that all the content has been translated, we will need to add your language to the website navigation. This will require opening `_includes/header.html`. Near the bottom of this file, you will find a line such as `<a href="/">{% t language.en %}</a>`. Change this line around a bit to match your language. Using our French example, we would add the following: `<a href="/fr">{% t language.fr %}</a>`. If other languages are listed, add your new language at the end of the listed languages.
 
-*** Additional information ***
+### Additional information
 
 The Masari guides are pulled from an external repository at this current time. Accessing our site at /guides will result in English only content (but will have everything else translated). You may submit a pull request on the (https://github.com/masari-project/masari-marketing)[masari-marketing] repository for your desired language. 
+
+### Questions?
+
+Should you have questions, we encourage you to open an [issue](https://github.com/masari-project/masari-project.github.io/issues/new). For more immediate assistance, visit us on [Discord](https://discord.gg/sMCwMqs) and make your statement in the #development channel.