diff --git a/README.md b/README.md
index 0bc29354..2ddd19c7 100644
--- a/README.md
+++ b/README.md
@@ -6,168 +6,181 @@
codeuino's open source social platform
-[](https://codeuino.slack.com) [](http://makeapullrequest.com) [](https://github.com/codeuino/Social-Platform-Donut/issues) [](https://www.gnu.org/licenses/gpl-3.0)
+[](https://codeuino.slack.com) [](http://makeapullrequest.com) [](https://github.com/codeuino/Social-Platform-Donut/issues) [](https://www.gnu.org/licenses/gpl-3.0) [](https://docs.codeuino.org/donut-social-networking-platform/)
-#### For frontend of this repo move to [this](https://github.com/codeuino/frontened) repository.
+# About
-
+Being inspired by the Cornucopia of various social hub this project has been developed taking into consideration about open source.
+Well, this is an Open Source Social networking hub which acts as a bridge between various Developers, Organisations and Open Source aspirants to elaborate on various things like Projects, Events, Discussion on various researches, Scholarships, Coding release and various other things updates.
-What is Donut?
---------
-Being inspired by the Cornucopia of various social hub this project has been developed taking into consideration about open source.
-
- Well, this is an Open Source Social networking hub which acts as a bridge between various Developers, Organisations and Open Source aspirants to elaborate on various things like #Projects, #Events, #Discussion on various researches, #Scholarships, #Coding release and various other things updates.
+The major priority of this project has been that this platform allows users to make their project "Open Sourced" and released them under various open source Organisations, experts which hold up a ring plate on this portal.
+
+This platform also makes users introduce and develops various solutions in the form of FOSS software to publish them for public use by integrating them with their social cause. Moreover, this project can be downloaded by any user, organization and can be used by them in their own custom way, making it run on their servers.
+
+### Frontend Technology Stack
+
+- SCSS: Styling web pages, html files
+- Javascript: Primary programing language
+- ReactJS v16.12: Javascript library for building User Interfaces
+- Bootstrap: Styling framework.
+
+Learn more about the donut platform at the [official donut documentation](https://docs.codeuino.org/donut-social-networking-platform/).
+
+---
+
+# Setting up the work environment.
+
+Few things are required before setting up the project locally,
+
+- **A Web Browser** - You can install any browser as per your preference e.g. Google Chrome etc. JavaScript works on any web browser on any OS.
+- **An Editor**- We prefer an editor which has built-in features of IntelliSense support and syntax error highlighter for speedy development. Download Visual Studio Code from [here](https://code.visualstudio.com/download).
+- **Node and Node Package Manager(NPM)**
+ Check if node and npm are already installed by running the following commands in the terminal
+ `node -v npm -v`
+ If the node and npm are installed
+ If not, install it in,
+- **Windows & MacOS**
+
+ Installing Node and NPM on Windows and macOS is straightforward because you can just use the provided installer:
+ Go to https://nodejs.org/en/
+ Select the button to download the LTS build that is "Recommended for most users".
+ Install Node by double-clicking on the downloaded file and following the installation prompts.
+
+- **Ubuntu**
+ The easiest way to install the most recent LTS version of Node 10.x is to use the [package manager](https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions) to get it from the Ubuntu _binary distributions_ repository. This can be done very simply by running the following two commands on your terminal:
+ `curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash - sudo apt-get install -y nodejs`
+ **\***
+
+# Setting up the donut frontend potion locally.
-The major priority of this project has been that this platform allows users to make their project "Open Sourced" and released them under various open source Organisations, experts which hold up a ring plate on this portal.
+**Forking The Repository**
-This platform also makes users introduce and develops various solutions in the form of FOSS software to publish them for public use by integrating them with their social cause. Moreover, this project can be downloaded by any user, organization and can be used by them in their own custom way, making it run on their servers.
-It is built on Node.js and utilizing mongoose as a database.
+The first step of setting the donut frontend locally is to fork the original repository. This creates a copy of that repository under your own account enabling you to begin working with the code. The rights to public repositories will be such that you can view the code, but not directly commit into the repository or create branches. This allows the project owners to control changes within their codebase.
-Technical Features
---------------------
-* Sign Up / Login Authentication
-* Node.js basic Password Authentication ( Uses Unique email and Password )
-* Third party access login
-* Sign Up as a User and Organisation
-* Write any Post that acts as a Feed ( with various formatting tools, tags effect, etc )
-* Propose any project that a person wants to raise as researched under various organizations and experts.
-* Write Events and get updates of various Events happening around.
-* Scholarship Raiser, Open Source Internships.
-* Open up the environment for the discussion through integrated Discussion platform
-* Act with Open Stat
-* Appropriate Dashboard with most APIs Activities log of projects and other things.
-* Sourced Packaged, Custom made software ( can be changed according to needs after downloading it.
-* Provides various opportunities to integrate many other Open Source projects recognized by organizations
+The forking step creates a copy to which you do have permission to commit and branch on and you can consider this your working copy of the project. You can make changes and commits here, safe in the knowledge that you will not affect the main repository.
+In order to fork the donut frontend repository visit [here](https://github.com/codeuino/social-platform-donut-frontend)
+
-Installation
-------------
+**Cloning the forked repository**
-[](https://nodejs.org/en/) [](http://npmjs.com/)
+In order to clone the forked repository visit fork of the donut repository under "your repositories" section and click on the “Clone or download” which will open a UI showing the Git URL. A button to the right hand side of the URL allows you to copy it into your clipboard.
-To get this project running locally on your machine follows the steps below in order:
+
+There are various graphical tools you can use to work with Git repositories but for simple procedures, the command line is often fastest.
-1. fork this repo
-2. clone the forked repo from your GitHub
-using the command `git clone https://github.com/username/Social-Platform-Donut.git` don't forget to replace the username in the URL
+Open a command window and navigate to the path where you would like to clone the repository.
+Use the following command to begin a clone:
- 
+```
+git clone https://github.com//social-platform-donut-frontend.git
+```
-3. Checkout to the development branch
+Once the command completes you will have a new folder containing the cloned repository. We can validate this by running the “dir” command. We can then move into that directory using the "cd social-platform-donut-frontend" command.
- ```shell
- git checkout development
- ```
+
-4. Setting up the project locally.
+**Setting up a remote upstream**
- ```shell
- npm install
- ```
+The next step is to set up a remote. Remotes simply represent paths or URLs to other versions of your repository. In our case, as we cloned from our fork on GitHub a default remote will have been setup for us called origin. This origin allows us to push and pull code from our forked repository hosted on GitHub. We can list the currently configured remotes on our machine using the “git remote” command.
-5. Setting up the local database instance
-
- You need to have a MongoDB atlas account to create local database.
- Check out [this link](https://www.youtube.com/watch?v=KKyag6t98g8) to setup MongoDB atlas.
- The mongodb URL should be pasted in `credential.js` files.
+Pushing and pulling from your own fork is very useful and this will be how you will work with the project most often. However, when working on that code, you’ll want to be starting from the most recent version of the code from the main donut-frontend repository. That code may have been updated and changed since you first made your fork. In order to get access to that latest code, we’ll setup a second remote which points to the main donut-frontend repository. We will not have commit rights there, so we cannot push changes, however, we will be able to fetch the latest commits that have occurred.
+To create a new remote we use the “git remote add” command, passing in a name for the new remote and the URL as arguments. In our case since we want the second remote to point towards the original donut-frontend repository we will use the follwing command. It's possible to name the remote anything you like, but the convention is to name it "upstream".
+```
+git remote add upstream https://github.com/codeuino/social-platform-donut-frontend.git
+```
-6. run this command to run on local
+**Installing the dependencies and running our local version of donut-frontend**
- ```shell
- nodemon server.js
- ```
- or
- ```shell
- node server.js
- ```
+The next step is to install the required dependencies to our newly created donut-frontend app. This could be done by running the following command in the terminal.
-HURRAY! you have done it just start contributing to the project.
+```
+npm install
+```
-Now open your browser and type the link `http://localhost:3000` to continue viewing project.
+The npm install command will install all the project dependencies mentioned in the package.json file.
+Once all the dependencies are completely installed the final step is to run our local instance using the following command.
-Setting Up Database
-------------
+```
+npm start
+```
+Now visit the [http://localhost:3000](http://localhost:3000) using your favorite browser to see your very own donut-frontend app in action!
-[](https://www.mongodb.com/download-center/community)
+There are few last steps to follow however before you can start exploring the donut platform.
+To get most out of locally setup frotnend environment, we highly suggest to setup an instance of the donut backend as well. The backend repository could be found at [https://github.com/codeuino/social-platform-donut-backend](https://github.com/codeuino/social-platform-donut-backend)
-Make sure you have MongoDB installed on your computer. If not get it here [MongoDB Community Server](https://www.mongodb.com/download-center/community)
+1. Once the backend environment is successfully setup, create a new Organization/Community by visiting the link [http://localhost:3000/setup](http://localhost:3000/setup). Follow the instructions and fill in the fields provided by the screen.
+2. The next step is sign up using a new admin account. This could be achieved by visiting the [http://localhost:3000/admin](http://localhost:3000/admin) and using the "Admin Account Signup card."
+3. Login using the newly created admin account.
-1. Open the terminal, locate the "scripts" folder and run the dbcreater.sh
+You are now all set to explore the donut platform!
- ```shell
- bash dbcreater.sh
- ```
+# Contributing to the donut frontend.
-Note: For windows user, run this command using [git bash](https://git-scm.com/download/win)
+**Choosing an issue**
+The first step when contributing to donut-frontend is to visit the project site and find an issue you would like to work on and which you think is suitable for your skill set. From the project homepage on GitHub you can click the Issues tab to navigate to a list of the open issues.
-## Contributions Best Practices
+
+After chosing an issue from the issues tab click on that particular issue to view more details about it. The issue details page provides the full information about the issue. Usually the top comment will include details of the bug or the feature that is needed. Issues can be raised by anyone and as a result, the level of detail may not always be sufficient to understand the problem or requirement. On allReady, the project owners and core contributors try to view new issues and triage them. This involves verifying the issue being reported is valid and where necessary, providing some further details or guidance. If it’s not clear what is needed from an issue, you can leave a comment to ask questions about it. If you have an idea for a solution, but want to run it past the project team before starting, work, you can leave a comment for that too. Issues are a good place for open discussions like this.
-[](https://github.com/codeuino/Social-Platform-Donut/issues)  
+**Working on an issue**
-**Commits**
-* Write clear meaningful git commit messages (Do read [this](http://chris.beams.io/posts/git-commit/)).
-* Make sure your PR's description contains GitHub's special keyword references that automatically close the related issue when the PR is merged. (Check [this](https://github.com/blog/1506-closing-issues-via-pull-requests) for more info)
-* When you make very very minor changes to a PR of yours (like for example fixing a failing Travis build or some small style corrections or minor changes requested by reviewers) make sure you squash your commits afterward so that you don't have an absurd number of commits for a very small fix. (Learn how to squash at [here](https://davidwalsh.name/squash-commits-git))
-* When you're submitting a PR for a UI-related issue, it would be really awesome if you add a screenshot of your change or a link to a deployment where it can be tested out along with your PR. It makes it very easy for the reviewers and you'll also get reviews quicker.
+When beginning work on an issue locally, the first thing you’ll need to do is to create a branch for that piece of work. There are many Git UI tools that allow you to create a branch, for this demo we’ll use the command line. To create and checkout a branch you can use a single command.
-## Community
+```
+git checkout -b
+```
-[](https://github.com/codeuino/Social-Platform-Donut/network) [](https://github.com/codeuino/Social-Platform-Donut/stargazers) 
+This command allows us to specify a name for our new branch and immediately check it out so we can work on it. It's common to name the branch with the issue number. For exmaple if we are working on the issue #223 it would be a good idea to name the branch,
-All feedback and suggestions are welcome!
+```
+git checkout -b 223
+```
-* 💬 Join the community on [Slack](https://join.slack.com/t/codeuino/shared_invite/enQtMzcxOTQwNzE4NzcxLWEyNzUxYjI0ZThiNWUyYWI5MzJlMTNmODMxN2NjMTcxODJkZmFhNTVkYmUyOTQ1YzgzNTlmMTVkYzVhMzdmNTQ )
-* 📣 Stay up to date on new features and announcements on the following:
- - [@Mailing List](codeuino-devel@googlegroups.com).
- - [@Discussion Portal](https://groups.google.com/d/forum/codeuino-devel).
- - [@Codeuino Wiki](wiki.codeuino.org).
+Once we are on our new branch we can make changes to the code which address the issue. When we have made the required changes that address a particular issue, we need to commit that code to our branch. We can use the “git status” command to view the changes since our last commit.
+```
+git status
+```
-## Sponsors/Partners
+We then use the “git add” command to stage the changes for the next commit. It's possible to add the files one by one by spcifying their relative path afterwards. For example if we want to add the corrections.js file in the same directory,
-Support this project by becoming a sponsor/collaborator/partner/contributors.
-[[Become a sponsor](https://codeuino.org/)]
+```
+git add corrections.js
+```
-#### Current
+However if you want to stage all the files that have been changed, it's also possible with the follwing command.
-| 
| 
|
-|:-:|:-:|
+```
+git add .
+```
+Next we will commit our staged changes using the “git commit” command. In this case we can use the following example:
-## Licensing
+```
+git commit -m "Fix readme typo"
+```
-[](https://github.com/codeuino/Social-Platform-Donut/blob/master/LICENSE)
+The -m option allows us to specify a message for our commit. It’s good practice to try and provide a succinct, but descriptive message for your commits. This helps a reviewer understand at a high level what was addressed in each commit.
-Donut An Open Source Social Collaborating platform is a web Based framework Software,
-
- Copyright (C) < 2018 Codeuino Contributors >
-This program is free software: you can redistribute it and/or modify
- it under the terms of the GNU General Public License V3 as published by
- the Free Software Foundation, either version 3 of the License, or
- (at your option) any later version.
+At this point we have made and committed out changes local to our development machine. Our final step is to push the changes to our fork of the allReady repository up on GitHub. We can do that using the “git push” command. We need to specify the name of the remote that we want to push to and the name of the branch we want to push up.
-This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details at OSI
+```
+git push origin 223
+```
-You should have received a copy of the GNU General Public License
- along with this program. If not, see [this](http://www.gnu.org/licenses/).
+Now the changes we have made are pushed into our fork in GitHub. The final step is to make a pull request . A **pull request** (PR) is a method of submitting contributions to an open development project. It occurs when a developer asks for changes committed to an external repository to be considered for inclusion in a project's main repository after the peer review.
-[](https://twitter.com/codeuino) [](https://github.com/codeuino/Social-Platform-Donut)
+In order to make a pull request, visit the forked repository on github. On the top right hand side a button will now be there mentioning that a pull request is ready to be made.
+Prior to making the PR make sure to choose the base branch as development branch using the dropdown.
+
+Click on the "compare and pull request" button to make the pull request!
-
-
-
-
-
-