SOC1-124: Updated comments in git initialisation script and started Readme

README.md

 # Accelerator System Top-Level
 
+This repo is the top-level repository which contains accelerator and SoC Labs provided design IP in forms of git subrepositories.
 
-This sample project shows how a project in GitLab looks for demonstration purposes. It contains issues, merge requests and Markdown files in many branches,
-named and filled with lorem ipsum.
+The SoC wiring is handled in this repository too, along with design and verification for accelerator wrappers.
 
-You can look around to get an idea how to structure your project and, when done, you can safely delete this project.
+## Creating own top-level
 
-[Learn more about creating GitLab projects.](https://docs.gitlab.com/ee/gitlab-basics/create-project.html)
+The first stage of putting your accelerator into a SoC is to build the accelerator in your own repository. 
+
+Once you have a custom design repository, you are able to fork the template System Top-level repository and make some changes.
+
+After forking, you need to add your own repository as a submodule. The first thing to do is to clone your new forked top-level.
+
+## Cloning 
+
+To clone this repository and its subrepository, use the following command:
+
+`git clone --recusrive $REPO_NAME`
+
+Once the repository and the subrepository has been cloned, the next stage is to initalise the environment variables and check out the sub repositories to a branch.
+
+First navigate to the top of this cloned repository and run:
+
+`source set_env.sh` 
+
+This sets the environment variables related to this project and creates visability to the scripts in the flow directory. Because of this, you scan now run:
+
+`soc-init`
+
+This checks out all the repositories to the `main` branch. You are then able to check out the sub repos to the desired branches.
+
+## Adding Submodule
+
+After setting up your workarea, you now need to add your accelerator design repository as a subrepo.
+
+From `$DESIGN_ROOT`, you are able to run:
+
+`git submodule status` 
+
+This lists the sub repositories and their branches. Make sure these are all you are expecting other than your design repo and you can then use the 
+
+`git submodule add -b $BRANCH $REPOSITORY_URL`
+
+to add the repo into this work area.
+
+You then need to push the .gitmodules file back to remote to save this configuration.
\ No newline at end of file

flow/socrepo-init → flow/soc-init

 #-----------------------------------------------------------------------------
-# SoC Labs socsim script to run required simulation
+# SoC Labs Workarea initialisation Script
+# - sets submodule branches to main - can then be checked out to other branches from there.
 # A joint work commissioned on behalf of SoC Labs, under Arm Academic Access license.
 #
 # Contributors