diff --git a/docs/contribute/_category_.json b/docs/contribute/_category_.json
new file mode 100644
index 0000000..eeb5ca1
--- /dev/null
+++ b/docs/contribute/_category_.json
@@ -0,0 +1,8 @@
+{
+ "label": "Contribute",
+ "position": 5,
+ "link": {
+ "type": "generated-index",
+ "description": "Want to help the UniversalPython movement? Here are some ways."
+ }
+}
diff --git a/docs/contribute/core.md b/docs/contribute/core.md
new file mode 100644
index 0000000..3ca0c34
--- /dev/null
+++ b/docs/contribute/core.md
@@ -0,0 +1,12 @@
+---
+sidebar_position: 1
+---
+
+# Improving UniversalPython
+
+There are tonnes of interesting challenges which, when solved, can make UniversalPython easier to use and more resilient:
+- [ ] In-transpiler translation of sentences (e.g. translating strings)
+- [ ] How can we manage imports of packages, and the functions inside of them?
+- [ ] Supporting new and old versions of Python
+
+Feel free to share more challenges in our [GitHub Discussions](https://github.com/UniversalPython/UniversalPython/discussions). We're ready for impact.
\ No newline at end of file
diff --git a/docs/tutorial-extras/img/docsVersionDropdown.png b/docs/contribute/img/docsVersionDropdown.png
similarity index 100%
rename from docs/tutorial-extras/img/docsVersionDropdown.png
rename to docs/contribute/img/docsVersionDropdown.png
diff --git a/docs/tutorial-extras/img/localeDropdown.png b/docs/contribute/img/localeDropdown.png
similarity index 100%
rename from docs/tutorial-extras/img/localeDropdown.png
rename to docs/contribute/img/localeDropdown.png
diff --git a/docs/contribute/improve-docs.md b/docs/contribute/improve-docs.md
new file mode 100644
index 0000000..3ca49af
--- /dev/null
+++ b/docs/contribute/improve-docs.md
@@ -0,0 +1,12 @@
+---
+sidebar_position: 1
+---
+
+# Improving the docs
+
+We maintain our docs on GitHub, using Docusaurus. Some important tasks which are pending:
+- [ ] Translation of the documentation to different languages
+- [ ] Making it easier for people to suggest new words and add them to the dictionary
+- [ ] Computer science education, via a YouTube channel or blogs, in Native languages
+
+Feel free to share more tasks in our [GitHub Discussions](https://github.com/UniversalPython/UniversalPython/discussions). We're ready for impact.
\ No newline at end of file
diff --git a/docs/contribute/translate.md b/docs/contribute/translate.md
new file mode 100644
index 0000000..23b3369
--- /dev/null
+++ b/docs/contribute/translate.md
@@ -0,0 +1,11 @@
+---
+sidebar_position: 3
+---
+
+# Translate into your language
+
+Are you a native speaker of a language and can contribute to making UniversalPython's keywords more accurate? Or want to add an entirely new language to UniversalPython? Look no further.
+
+The list of languages supported are visible [here](https://github.com/UniversalPython/UniversalPython/tree/%D9%85%D8%B1%DA%A9%D8%B2/urdupython/languages).
+
+Our translations are (currently) managed in the form of [YAML](https://yaml.org/) files, like [this one right here](https://github.com/UniversalPython/UniversalPython/blob/%D9%85%D8%B1%DA%A9%D8%B2/urdupython/languages/hi/hi_native.lang.yaml). Simply make one for your own language, and share it with us by opening a Pull Request on [our GitHub](https://github.com/UniversalPython/UniversalPython/), or simply sharing it with us on email at info@grayhat.com.pk
\ No newline at end of file
diff --git a/docs/examples/_category_.json b/docs/examples/_category_.json
new file mode 100644
index 0000000..a1f0d19
--- /dev/null
+++ b/docs/examples/_category_.json
@@ -0,0 +1,8 @@
+{
+ "label": "Examples",
+ "position": 4,
+ "link": {
+ "type": "generated-index",
+ "description": "Learn more by checking out code examples of UniversalPython which demonstrate its capabilities."
+ }
+}
diff --git a/docs/examples/playground.md b/docs/examples/playground.md
new file mode 100644
index 0000000..197960f
--- /dev/null
+++ b/docs/examples/playground.md
@@ -0,0 +1,7 @@
+---
+sidebar_position: 3
+---
+
+# Playground
+
+You can try out UniversalPython in our [online playground](https://universalpython.github.io). No installations required, it all runs in your browser!
\ No newline at end of file
diff --git a/docs/installation.md b/docs/installation.md
new file mode 100644
index 0000000..9022892
--- /dev/null
+++ b/docs/installation.md
@@ -0,0 +1,30 @@
+---
+sidebar_position: 2
+---
+
+# Installation
+
+Get started with using UniversalPython.
+
+## Before you begin...
+
+You will require:
+- Some basic knowledge about Python
+- Python 3+ installed in your computer
+- Pip 3+ installed in your computer
+
+> We need help in making this documentation more accessible to people of different languages, from around the world. And more easy-to-understand for complete beginners to programming. Reach out to us at info@grayhat.com.pk if you'd like to help, or drop a Pull Request at [our repo](https://github.com/UniversalPython/UniversalPython.github.io).
+
+## Getting Started
+
+Get started with UniversalPython by installing it from PyPI. Our package name is currently "urdupython" (changes to this soon!)
+
+```
+pip install urdupython
+```
+
+## Installing from source
+1. Download the [UniversalPython repo](https://github.com/UniversalPython/UniversalPython/) as a ZIP, or clone it via Git.
+2. Open the repo's folder in your Terminal.
+3. Run ```pip install -e .```
+
diff --git a/docs/intro.md b/docs/intro.md
index 8a2e69d..a754662 100644
--- a/docs/intro.md
+++ b/docs/intro.md
@@ -2,46 +2,18 @@
sidebar_position: 1
---
-# Tutorial Intro
+# Welcome
-Let's discover **Docusaurus in less than 5 minutes**.
+Welcome to the UniversalPython documentation! Learn more about UniversalPython, the motivation behind it, and how it works.
-## Getting Started
+## Our vision
-Get started by **creating a new site**.
+We know how hard it is to know multiple languages and get started with computer science and programming. Almost all the material you search for, all the books, videos, and even all of the major programming languages of world, are in English. Did you know that only 27% of the entire world's population knows English? How does the rest of the world learn? This is something we have yet to understand.
-Or **try Docusaurus immediately** with **[docusaurus.new](https://docusaurus.new)**.
+## History
-### What you'll need
+UniversalPython started off as UrduPython; the idea of a young student in NUCES, Islamabad, Pakistan. The motivation is simple; programming languages have a basic syntax comprising of "keywords". If there was a basic mapping of those keywords into other languages, the people of Pakistan (a country of **77 established languages**) could learn programming much better.
-- [Node.js](https://nodejs.org/en/download/) version 16.14 or above:
- - When installing Node.js, you are recommended to check all checkboxes related to dependencies.
+## Progress
-## Generate a new site
-
-Generate a new Docusaurus site using the **classic template**.
-
-The classic template will automatically be added to your project after you run the command:
-
-```bash
-npm init docusaurus@latest my-website classic
-```
-
-You can type this command into Command Prompt, Powershell, Terminal, or any other integrated terminal of your code editor.
-
-The command also installs all necessary dependencies you need to run Docusaurus.
-
-## Start your site
-
-Run the development server:
-
-```bash
-cd my-website
-npm run start
-```
-
-The `cd` command changes the directory you're working with. In order to work with your newly created Docusaurus site, you'll need to navigate the terminal there.
-
-The `npm run start` command builds your website locally and serves it through a development server, ready for you to view at http://localhost:3000/.
-
-Open `docs/intro.md` (this page) and edit some lines: the site **reloads automatically** and displays your changes.
+We went public with UniversalPython in March, 2023. We're looking for amazing maintainers and contributers, and wish to initiate a movement across the world to make programming languages and computer science education accessible to all.
\ No newline at end of file
diff --git a/docs/tutorial-basics/_category_.json b/docs/tutorial-basics/_category_.json
index 2e6db55..ef2ff88 100644
--- a/docs/tutorial-basics/_category_.json
+++ b/docs/tutorial-basics/_category_.json
@@ -1,8 +1,8 @@
{
- "label": "Tutorial - Basics",
+ "label": "Tutorial",
"position": 2,
"link": {
"type": "generated-index",
- "description": "5 minutes to learn the most important Docusaurus concepts."
+ "description": "5 minutes to learn the most important UniversalPython concepts."
}
}
diff --git a/docs/tutorial-basics/congratulations.md b/docs/tutorial-basics/congratulations.md
deleted file mode 100644
index 04771a0..0000000
--- a/docs/tutorial-basics/congratulations.md
+++ /dev/null
@@ -1,23 +0,0 @@
----
-sidebar_position: 6
----
-
-# Congratulations!
-
-You have just learned the **basics of Docusaurus** and made some changes to the **initial template**.
-
-Docusaurus has **much more to offer**!
-
-Have **5 more minutes**? Take a look at **[versioning](../tutorial-extras/manage-docs-versions.md)** and **[i18n](../tutorial-extras/translate-your-site.md)**.
-
-Anything **unclear** or **buggy** in this tutorial? [Please report it!](https://github.com/facebook/docusaurus/discussions/4610)
-
-## What's next?
-
-- Read the [official documentation](https://docusaurus.io/)
-- Modify your site configuration with [`docusaurus.config.js`](https://docusaurus.io/docs/api/docusaurus-config)
-- Add navbar and footer items with [`themeConfig`](https://docusaurus.io/docs/api/themes/configuration)
-- Add a custom [Design and Layout](https://docusaurus.io/docs/styling-layout)
-- Add a [search bar](https://docusaurus.io/docs/search)
-- Find inspirations in the [Docusaurus showcase](https://docusaurus.io/showcase)
-- Get involved in the [Docusaurus Community](https://docusaurus.io/community/support)
diff --git a/docs/tutorial-basics/create-a-blog-post.md b/docs/tutorial-basics/create-a-blog-post.md
deleted file mode 100644
index ea472bb..0000000
--- a/docs/tutorial-basics/create-a-blog-post.md
+++ /dev/null
@@ -1,34 +0,0 @@
----
-sidebar_position: 3
----
-
-# Create a Blog Post
-
-Docusaurus creates a **page for each blog post**, but also a **blog index page**, a **tag system**, an **RSS** feed...
-
-## Create your first Post
-
-Create a file at `blog/2021-02-28-greetings.md`:
-
-```md title="blog/2021-02-28-greetings.md"
----
-slug: greetings
-title: Greetings!
-authors:
- - name: Joel Marcey
- title: Co-creator of Docusaurus 1
- url: https://github.com/JoelMarcey
- image_url: https://github.com/JoelMarcey.png
- - name: Sébastien Lorber
- title: Docusaurus maintainer
- url: https://sebastienlorber.com
- image_url: https://github.com/slorber.png
-tags: [greetings]
----
-
-Congratulations, you have made your first post!
-
-Feel free to play around and edit this post as much you like.
-```
-
-A new blog post is now available at [http://localhost:3000/blog/greetings](http://localhost:3000/blog/greetings).
diff --git a/docs/tutorial-basics/create-a-document.md b/docs/tutorial-basics/create-a-document.md
deleted file mode 100644
index ffddfa8..0000000
--- a/docs/tutorial-basics/create-a-document.md
+++ /dev/null
@@ -1,57 +0,0 @@
----
-sidebar_position: 2
----
-
-# Create a Document
-
-Documents are **groups of pages** connected through:
-
-- a **sidebar**
-- **previous/next navigation**
-- **versioning**
-
-## Create your first Doc
-
-Create a Markdown file at `docs/hello.md`:
-
-```md title="docs/hello.md"
-# Hello
-
-This is my **first Docusaurus document**!
-```
-
-A new document is now available at [http://localhost:3000/docs/hello](http://localhost:3000/docs/hello).
-
-## Configure the Sidebar
-
-Docusaurus automatically **creates a sidebar** from the `docs` folder.
-
-Add metadata to customize the sidebar label and position:
-
-```md title="docs/hello.md" {1-4}
----
-sidebar_label: 'Hi!'
-sidebar_position: 3
----
-
-# Hello
-
-This is my **first Docusaurus document**!
-```
-
-It is also possible to create your sidebar explicitly in `sidebars.js`:
-
-```js title="sidebars.js"
-module.exports = {
- tutorialSidebar: [
- 'intro',
- // highlight-next-line
- 'hello',
- {
- type: 'category',
- label: 'Tutorial',
- items: ['tutorial-basics/create-a-document'],
- },
- ],
-};
-```
diff --git a/docs/tutorial-basics/create-a-page.md b/docs/tutorial-basics/create-a-page.md
deleted file mode 100644
index 20e2ac3..0000000
--- a/docs/tutorial-basics/create-a-page.md
+++ /dev/null
@@ -1,43 +0,0 @@
----
-sidebar_position: 1
----
-
-# Create a Page
-
-Add **Markdown or React** files to `src/pages` to create a **standalone page**:
-
-- `src/pages/index.js` → `localhost:3000/`
-- `src/pages/foo.md` → `localhost:3000/foo`
-- `src/pages/foo/bar.js` → `localhost:3000/foo/bar`
-
-## Create your first React Page
-
-Create a file at `src/pages/my-react-page.js`:
-
-```jsx title="src/pages/my-react-page.js"
-import React from 'react';
-import Layout from '@theme/Layout';
-
-export default function MyReactPage() {
- return (
- This is a React pageMy React page
-