Merge pull request #44 from chmodshubham/main

Enhance styling and structure across documentation

Author: chmodshubham

.sphinx/_static/custom.css

@@ -4,7 +4,7 @@
 }
 
 .p-navigation__nav {
-  background: linear-gradient(135deg, #6B9BD1 0%, #4A90E2 100%);
+  background: #1b3a5f;
   display: flex;
   font-family: var(--font-stack);
   padding: 0.05rem 0;
@@ -81,7 +81,7 @@ ul.p-navigation__links li a {
   position: relative;
   text-align: left;
   text-overflow: ellipsis;
-  transition-duration: .1s;
+  transition-duration: 0.1s;
   transition-property: background-color, color, opacity;
   transition-timing-function: cubic-bezier(0.215, 0.61, 0.355, 1);
   white-space: nowrap;
@@ -110,7 +110,7 @@ ul.p-navigation__links .p-dropdown__link:hover {
 
 ul.p-navigation__links .p-navigation__sub-link {
   background: var(--color-background-primary);
-  padding: .5rem 0 .5rem .5rem;
+  padding: 0.5rem 0 0.5rem 0.5rem;
   font-weight: 300;
 }
 
@@ -196,4 +196,4 @@ ul.more-links-dropdown {
   ul.p-navigation__links {
     margin-left: calc(50% - 41em);
   }
-}
+}

.sphinx/_static/header.css

@@ -45,9 +45,9 @@
   font-weight: 600;
 }
 
-/* Style buttons and interactive elements */
+/* Style buttons and interactive elements - exclude UI control buttons */
 .btn,
-button,
+button:not(.copybtn):not(.theme-toggle-icon):not(.back-to-top):not(.sidebar-toggle):not([aria-label]):not(.sphinx-tabs-tab),
 input[type="submit"] {
   background: linear-gradient(
     135deg,
@@ -96,49 +96,38 @@ table.docutils {
 }
 
 table.docutils th {
-  background: linear-gradient(
-    135deg,
-    var(--ngkore-primary),
-    var(--ngkore-secondary)
-  );
+  background: var(--ngkore-primary);
   color: white;
 }
 
 /* Keep original navigation breadcrumbs styling */
 
-/* Style back to top button */
+/* Style back to top button - transparent */
 .back-to-top {
-  background: white;
-  color: var(--ngkore-bg-primary);
-  border-radius: 40%;
+  background: transparent !important;
+  color: var(--color-foreground-secondary);
+  border-radius: 50%;
   transition: all 0.3s ease;
-  /* align-items: center; */
+  border: 1px solid rgba(0, 0, 0, 0.1);
 }
 
 .back-to-top:hover {
-  background: white;
-  color: var(--ngkore-bg-primary);
-  /* transform: scale(1.05); */
+  background: rgba(0, 0, 0, 0.05) !important;
+  color: var(--color-foreground-primary);
+  border-color: rgba(0, 0, 0, 0.2);
 }
 
 /* Dark theme support for back to top button */
 body[data-theme="dark"] .back-to-top {
-  background: linear-gradient(
-    135deg,
-    var(--ngkore-primary),
-    var(--ngkore-secondary)
-  );
-  color: white;
+  background: transparent !important;
+  color: var(--color-foreground-secondary);
+  border: 1px solid rgba(255, 255, 255, 0.1);
 }
 
 body[data-theme="dark"] .back-to-top:hover {
-  background: linear-gradient(
-    135deg,
-    var(--ngkore-secondary),
-    var(--ngkore-primary)
-  );
-  color: white;
-  /* transform: scale(1.05); */
+  background: rgba(255, 255, 255, 0.05) !important;
+  color: var(--color-foreground-primary);
+  border-color: rgba(255, 255, 255, 0.2);
 }
 
 /* Style theme toggle button */

.sphinx/_static/ngkore-theme.css

@@ -127,6 +127,7 @@
 
 html_css_files = [
     'custom.css',
+    'header.css',
     'github_issue_links.css',
     'furo_colors.css',
     'bottom-logo.css'

conf.py

@@ -1,28 +1,47 @@
 # NgKore Documentation
 
-NgKore (_ngkorefoundation.org_) is an open-source community driving innovation across Post-Quantum Cryptography (PQC), eBPF, 5G Advanced, 6G, O-RAN, NTN, AI/ML, Blockchain, Quantum technologies, and Cloud-Native Architectures.
+## Overview
 
-## Focus Areas
+NgKore Foundation (_ngkorefoundation.org_) is an open-source community advancing research and development in next-generation network infrastructure, quantum-resistant cryptography, and cloud-native architectures. The foundation focuses on bridging academic research with production-ready implementations across telecommunications, distributed systems, and emerging network technologies.
 
-**Core Technologies**
+## Technical Domains
 
-- {doc}`5G Core Networks <5g-core/index>` - Next-generation mobile networks
-- {doc}`O-RAN Interoperability <oran/index>` - Open radio access networks
+### Network Infrastructure
 
-**Security & Cryptography**
+{doc}`5G Core Networks <5g-core/index>`
+: Standards-compliant 5G core network implementations, service-based architecture, and network function virtualization.
 
-- {doc}`Post-Quantum Cryptography <pqc/index>` - Future-proof encryption
-- {doc}`Network Security <security/index>` - Advanced protection mechanisms
+{doc}`O-RAN Interoperability <oran/index>`
+: Open radio access network specifications, intelligent RAN controllers, and vendor-neutral interfaces.
 
-**Emerging Technologies**
+{doc}`Non-Terrestrial Networks <ntn/index>`
+: Satellite communications, aerial connectivity platforms, and hybrid terrestrial-non-terrestrial network architectures.
 
-- {doc}`AI/ML Integration <ai-ml/index>` - Intelligent network automation
-- {doc}`Non-Terrestrial Networks <ntn/index>` - Satellite and aerial connectivity
+### Security & Cryptography
 
-**Tools & Orchestration**
+{doc}`Post-Quantum Cryptography <pqc/index>`
+: Quantum-resistant algorithms, lattice-based cryptography, and migration strategies for post-quantum security.
 
-- {doc}`eBPF Technology & Tools <ebpf/index>` - High-performance packet processing
-- {doc}`Kernel Bypass Technologies <kernel-bypass/index>` - Ultra-low latency networking
+{doc}`Network Security <security/index>`
+: Advanced threat detection, zero-trust architectures, and secure network function implementations.
+
+### Performance & Optimization
+
+{doc}`eBPF Technology & Tools <ebpf/index>`
+: Extended Berkeley Packet Filter for programmable packet processing, observability, and security enforcement.
+
+{doc}`Kernel Bypass Technologies <kernel-bypass/index>`
+: DPDK, XDP, and user-space networking for ultra-low latency data plane operations.
+
+### Intelligent Systems
+
+{doc}`AI/ML Integration <ai-ml/index>`
+: Machine learning for network optimization, predictive analytics, and autonomous network management.
+
+### Practical Implementation
+
+{doc}`Tutorials <tutorials/index>`
+: Step-by-step deployment guides, integration examples, and reference architectures.
 
 ---
 

index.md

@@ -5,4 +5,5 @@
 
 introduction-to-ntn
 oai-ntn
-```
+../../tutorials/oai/oai-nr-5g-ntn
+```

ntn/oai/index.md

@@ -163,7 +163,7 @@ The deployment may take time as it pulls several large images. Open a separate t
 kubectl get pods -A
 ```
 
-```bash
+```console
 ubuntu@ubuntu:~/o1-adapter$ kubectl get pods -A
 NAMESPACE          NAME                                                READY   STATUS      RESTARTS       AGE
 cert-manager       cert-manager-5bd57786d4-vcdxb                       1/1     Running     0              3h32m

tutorials/osc-oam.md

@@ -25,7 +25,7 @@ The deployment follows a **3GPP-aligned CU/DU architecture** and is suitable for
 
 ## High-Level Architecture
 
-```
+```console
                  +-----------------------------+
                  |           VM 1              |
                  |                             |

tutorials/srsran/srsran-f1ap-split.md

@@ -24,7 +24,7 @@ This setup is intended for **testing, learning, and research**, and runs entirel
 
 ## Architecture Overview
 
-```
+```console
 +-----------------------------+
 |        Ubuntu 22.04 VM      |
 |                             |