Add future stakeholders to the docs (#15)

* upgrade dependencies

* delete non-fs images

* add main repo

* add new theme

* add stakeholders and rewrite

Author: ilhanu

.gitignore

@@ -18,3 +18,4 @@
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
+.vscode/settings.json

docs/intro.md

@@ -1,16 +1,47 @@
 ---
 sidebar_position: 1
 ---
-# Intro
 
-The Fair Squares (FS) platform enables fractional ownership of real estate for future rental agreements. With FS, the housing market becomes more transparent, fair and accessible for tenants, co-owners and investors. 
-At its core, FS is a community-agreed protocol that executes rental agreements with the houses that were invested in. This makes it possible to have affordable housing with a return on social investments.
-Individuals in communities can own, manage homes and new entrants can easily enter the rental market. The Fair Squares social crowd financing model allows us to achieve a 30% lower (free market) rent. By bundling the capital of co-investors combined with governance, this gives the stakeholders the tools to create an ecosystem that can be self-sovereign. 
+# Introduction to Fair Squares (FS)
 
+Welcome to Fair Squares (FS) – a transformative platform designed to reshape the future of equitable real estate ownership. FS bridges the gap between homeowners, renters, properties, and investors. We're on a mission to create an affordable housing landscape where house investors not only see financial returns but also drive positive societal change, while renters find cost-effective housing solutions.
 
-To learn more and get in touch with us, please join our [discord channel FS](https://discord.gg/5u3dxE49V5)
+Our vision is to foster a housing market that’s transparent, equitable, and accessible for all participants: tenants, co-owners, and investors. Central to FS is a community-endorsed protocol that oversees rental agreements with properties that have been jointly invested in. This model allows communities to own and manage homes, welcoming new entrants into the rental landscape. Furthermore, our unique crowd-financing approach offers up to 30% lower rent compared to the free market, aligning the interests of stakeholders in a self-sovereign ecosystem.
 
-### What you want to do ? 
+### Our Mission and Vision
 
-For further navigation on this website we have 3 main categories: Learn, Guides and Build. Please use the sidebar on the left to find the information you are looking for.
+While our goal is to make the housing market more accessible and fair, it's also about empowering potential real estate investors. Many seek to make a social impact but may not have the resources for a direct property purchase. Our system encourages a coordinated effort among stakeholders, ensuring alignment towards our mission, all governed by strict standards for fairness and transparency. This adaptable model is driven by its stakeholders, ensuring housing equity remains at its forefront.
 
+### Engage with Us
+
+For deeper insights into our initiative or to connect with like-minded individuals, join our [FS Discord channel](https://discord.gg/5u3dxE49V5). We're also proud to announce that our recent advancements were supported and recognized by the [Web3 Foundation Grants Program](https://github.com/w3f/Grants-Program).
+
+### How Does Fair Squares Operate?
+
+<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/6l1n9SsK-yc" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
+
+### Our Approach
+
+We envision Fair Squares not as a traditional business, but as a neutral housing protocol. The protocol's primary objective is to address the core need of housing, aiming to mold this into a universally consistent, predictable, and affordable solution. Revenue generated will be governed by its token holders, stemming from various transactions on the platform.
+
+<!-- ### Governance Structure
+
+We've established a three-tiered governance framework to ensure comprehensive oversight and management:
+
+1. **Economic and Technical Tier:** Covering payment alternatives, KYC integrations, economic parameter changes, protocol updates, and compliance.
+
+2. **Housing Protocol Tier:** Addressing return-on-rent, juror appointments, concerns, and parameter suggestions.
+
+3. **Property Tier:** Focusing on maintenance, liability, insurance, representation, and tenancy agreements.
+
+### Token Distribution
+
+Our utmost priority lies in ensuring fairness in token distribution. Tokens, denoting protocol ownership and governance, will be distributed over an extended period, closely linked to active participation. Their primary function is to oversee governance and represent ownership within the protocol.
+
+To dive deeper, explore our content categories: Learn, Guides, and Build. Navigate using the sidebar. Specifically, you'll find:
+
+- **Light Paper**: Our foundational principles and mission.
+- **Stakeholder Analysis**: An understanding of the ecosystem's key players.
+- **Design and Architecture of Fair Squares**: An in-depth look at our framework. -->
+
+We're glad to have you on this journey towards a more equitable housing future. Welcome aboard!