Merge branch 'feature/new-way' of https://github.com/aragon/developer…

…-portal into feature/new-way

components/home/modules/ROOT/pages/index.adoc

@@ -1,18 +1,17 @@
 = Documentation
 
-Explore our guides and examples to learn how. TODO
+Aragon is a secure and modular tech stack for organizations to manage their protocols and assets onchain. Built on battle-tested infrastructure, Aragon empowers teams to create, manage, and upgrade decentralized organizations with confidence. Our comprehensive suite of tools enables everything from basic multisig management to complex, multi-stage governance systems.
 
-== The modular governance stack
 
-TDOO Explanation here
+== Aragon OSx
 
-=== Aragon OSx
+OSx is our Ethereum-based smart contract framework. It enables organizations to deploy custom governance tailored to their unique needs and securely adapt over time. It was designed to overcome the monolithic one-size-fits-approach commonly used by onchain organizations.
 
-TODO Docs here
+**The central principle behind OSx is that permissions are the core primitive that enables effective governance in any complex organization**.
 
-=== Plugin marketplace
+== Aragon Plugin Marketplace
 
-Governance logic is encapsulated in reusable contracts called _plugins_.
+Governance logic and other functionality is encapsulated in reusable contracts called _plugins_.
 
 Plugins are granted specific permissions depending what you want them to do. In practice, they often act as governing bodies or decision-making processes. For example, a token voting plugin or multisig plugin define all of their unique governance logic within the plugin itself. This “separation of concerns” keeps the protocol focused and ultimately more flexible.
 
@@ -27,46 +26,39 @@ The core plugins currently supported by Aragon are:
   * *Staged Proposal Processor*: Proposals are created and progress through any number of stages, with other plugins either voting to approve or veto the proposal. The SPP plugin is essentially a cross-plugin state manager that enables governance processes with multiple stages and multiple governing bodies.
 
 
+**Explore or publish your own community-built plugins** that can be used to extend any OSx-based organization with new governance logic.
+
+
 [.card-section]
 
-== Governance Toolingz
+== Governance Tooling
 
-Other description here.
+The Governance UI Kit and Governance App Template are used to build custom applications and UIs that integrate seamlessly with OSx. 
 
 [.card-section.card-section-2col]
 ====
 [.card.card-primary.card-contracts]
 --
-xref:contracts::index.adoc[[.card-title]#Contracts# [.card-body]#pass:q[A library of modular, reusable, and secure smart contracts, written in Solidity.]#]
---
-
-[.card.card-primary.card-defender]
---
-xref:defender::index.adoc[[.card-title]#Defender# [.card-body]#pass:q[A mission-critical developer security platform to code, audit, deploy, monitor, and operate blockchain applications.]#]
+xref:osx-contracts::index.adoc[[.card-title]#Osx Contracts# [.card-body]#pass:q[A smart contract framework built on Solidity, designed for creating and managing decentralized organizations.]#]
 --
 ====
 
-[.card.card-secondary.card-upgrades]
---
-xref:upgrades.adoc[[.card-title]#Upgrades# [.card-body]#pass:q[A comprehensive suite of contracts and tooling to deploy and manage upgradeable contracts on Ethereum.]#]
---
-
-[.card.card-secondary.card-contracts-cairo]
+[.card.card-secondary.card-token-voting]
 --
-xref:contracts-cairo::index.adoc[[.card-title]#Contracts for Cairo# [.card-body]#pass:q[A library for secure smart contract development written in Cairo for Starknet.]#]
+xref:token-voting::index.adoc[[.card-title]#Token Voting# [.card-body]#pass:q[A governance plugin that enables token-weighted voting.]#]
 --
 
-[.card.card-secondary.card-contracts-stylus]
+[.card.card-secondary.card-multisig]
 --
-xref:contracts-stylus::index.adoc[[.card-title]#Contracts for Stylus# [.card-body]#pass:q[A library for secure smart contract development written in Rust for Arbitrum Stylus.]#]
+xref:multisig::index.adoc[[.card-title]#Multisig# [.card-body]#pass:q[A governance plugin that enables a group of addresses to manage an organization through approval-based decision making.]#]
 --
 
-[.card.card-secondary.card-substrate-runtimes]
+[.card.card-secondary.card-admin]
 --
-xref:substrate-runtimes::index.adoc[[.card-title]#Substrate Runtimes# [.card-body]#pass:q[A collection of runtime templates for parachain development on Polkadot.]#]
+xref:admin::index.adoc[[.card-title]#Admin# [.card-body]#pass:q[A governance plugin that grants direct execution rights to create and execute proposals without voting or approval processes.]#]
 --
 
-[.card.card-secondary.card-solidity-docgen]
+[.card.card-secondary.card-spp]
 --
-https://github.com/OpenZeppelin/solidity-docgen[[.card-title]#Solidity Docgen# [.card-body]#pass:q[A tool for automatically generating documentation based on the natspec comments of your Solidity contracts.]#]
+xref:spp::index.adoc[[.card-title]#Staged Proposal Processor# [.card-body]#pass:q[A governance plugin that enables multi-stage workflows, allowing to implement complex decision-making processes with multiple approval or veto checkpoints.]#]
 --

ui/src/css/components/cards.scss

@@ -159,28 +159,28 @@
 
 .card-contracts a {
   --card-icon: url(../images/contracts_white.svg);
-  background-image: linear-gradient(45deg, #6746d6 0%, #a134d1 100%);
+  background-image: linear-gradient(45deg, var(--guk-color-primary-400) 0%, var(--guk-color-primary-900) 100%);
 }
 
 .card-defender a {
   --card-icon: url(../images/defender_white.svg);
-  background-image: linear-gradient(-135deg, #00e1d4 0%, #00c7f2 100%);
+  background-image: conic-gradient(45deg, var(--guk-color-primary-400) 0%, var(--guk-color-primary-900) 100%);
 }
 
-.card-upgrades {
-  --card-icon: url(../images/icons/upgrades-plugins.svg);
+.card-token-voting {
+  --card-icon: url(../images/icons/token-voting.svg);
 }
 
-.card-contracts-cairo {
-  --card-icon: url(../images/icons/contracts-cairo.svg);
+.card-multisig {
+  --card-icon: url(../images/icons/multisig.svg);
 }
 
-.card-contracts-stylus {
-  --card-icon: url(../images/icons/contracts-stylus.svg);
+.card-admin {
+  --card-icon: url(../images/icons/admin.svg);
 }
 
-.card-substrate-runtimes {
-  --card-icon: url(../images/icons/substrate-runtimes.svg);
+.card-spp {
+  --card-icon: url(../images/icons/spp.svg);
 }
 
 .card-test-environment {

ui/src/css/specific/navigation.scss

@@ -34,10 +34,11 @@
   padding: 0 1rem;
   font-size: 0.8em;
   font-family: var(--guk-font-family); /* Replaces var(--heading) */
-  color: var(--guk-color-neutral-600); /* Replaces var(--aluminum-5) */
+  color: var(--guk-color-neutral-300); /* Replaces var(--aluminum-5) */
   letter-spacing: 0.05em;
   font-weight: var(--guk-font-weight-semibold); /* Replaces var(--weight-bold) */
   text-transform: uppercase;
+  margin-top: var(--guk-space-5);
 }
 
 .btn-back {