refine project documentation for clarity and consistency across AstraKernel, CodeAstra, DevLog, and index pages

chrisdedman · chrisdedman · commit 65ff8f681043 · 2025-08-13T18:19:26.000-07:00
diff --git a/website/projects/astrakernel.md b/website/projects/astrakernel.md
@@ -4,8 +4,8 @@ title: AstraKernel
 
 # AstraKernel ~ A minimal ARM kernel for QEMU
 
-AstraKernel is a minimal experimental kernel written in C and ARM assembly, designed to run on 
-QEMU's VersatilePB (ARM926E) emulated platform. This project currently 
+AstraKernel is a minimal experimental kernel written in modern C and ARM assembly, designed to run on 
+**QEMU's VersatilePB (ARM926E)** emulated platform. This project currently 
 demonstrates how to bootstrap a system, set up the stack, zero the `.bss` 
 section, and perform basic UART output (printing text to the serial console).
 
@@ -28,41 +28,9 @@ Type away, explore, have fun.
 - Memory-mapped UART output for terminal messages
 - Runs under QEMU
 
-## Building
-
-### Native Build
-
-Make sure you have an ARM cross-compiler installed (e.g., `arm-none-eabi-gcc`) and `qemu-system-arm`.
-
-```sh
-make
-```
-
-<Badge type="tip" text="Important" />
- 
-> `make` will clean, build, and run the kernel in QEMU. You can also run 
-`make qemu` to run the kernel without cleaning or building it again.
-
-### Docker Build
-
-If you have docker installed, you can also run AstraKernel through a docker container:
-
-```sh
-make docker
-```
-
-<Badge type="tip" text="Important" />
-
-> `make docker` will pull from the most recent `main` commit from the upstream repository
-> `https://github.com/sanbox-science/AstraKernel.git`.
-> If you wish to use a local copy, you can run `make docker-dev`, which will copy all
-> local build files into the repository.
-
 ## Documentation
 
 For more details about this kernel, refer to the [AstraKernel Documentation](https://github.com/sandbox-science/AstraKernel/blob/main/doc/AstraKernelManual.pdf).
 
-<Badge type="info" text="Note" />
-
-> The manual is a work in progress and may not cover all features yet.
+> <Badge type="info" text="Note" /> The manual is a work in progress and may not cover all features yet.
 
diff --git a/website/projects/codeastra.md b/website/projects/codeastra.md
@@ -7,15 +7,11 @@ title: CodeAstra
 
 <h1 align="center">CodeAstra ~ Modern Code Editor</h1>
 
-CodeAstra is a modern, extensible, and lightweight code editor built using C++ and Qt6, designed to offer a fast, customizable, and feature-rich development experience. Inspired by NeoVim and VSCode, it **will** provide efficient file navigation, syntax highlighting, and a powerful plugin system, making it an ideal choice for developers who need speed, flexibility, and control. With a focus on performance and usability, the editor **will** support split views, an integrated terminal, customizable key bindings, and seamless Git integration, catering to both beginners and power users.
+CodeAstra is a modern, extensible, and lightweight code editor built using modern C++ and Qt6, designed to offer a fast, customizable, and feature-rich development experience. Inspired by NeoVim and VSCode, it provide an efficient file navigation, syntax highlighting, and potentically a powerful plugin system, making it an ideal choice for developers who need speed, flexibility, and control. With a focus on performance and usability, the editor **will** support split views, an integrated terminal, customizable key bindings, and seamless Git integration, catering to both beginners and power users.
 
-<Badge type="info" text="Note" />
+> <Badge type="info" text="Note" /> CodeAstra is **under active development**. Stay tuned for updates or feel free to contribute and help shape its future!
 
-> CodeAstra is **under active development**. Stay tuned for updates or feel free to contribute and help shape its future!
-
-<Badge type="tip" text="Important" />
-
-> CodeAstra has been tested on macOS and Linux and works as expected on those platforms. The project has not been tested natively on Windows, but it works when using **WSL** (Windows Subsystem for Linux). Native Windows support is not guaranteed. 
+> <Badge type="tip" text="Important" /> CodeAstra has been tested on macOS and Linux and works as expected on those platforms. The project has not been tested natively on Windows, but it works when using **WSL** (Windows Subsystem for Linux). Native Windows support is not guaranteed. 
 
 ## How to install the project
 Please, check the [wiki](https://github.com/sandbox-science/CodeAstra/wiki) for recommended installation instructions.
@@ -25,3 +21,5 @@ Please, check the [wiki](https://github.com/sandbox-science/CodeAstra/wiki) for
 - Make
 - g++ compiler (with support of C++20 and beyond)
 - Qt6 Framework
+
+**Repository**: https://github.com/sandbox-science/CodeAstra
diff --git a/website/projects/devlog.md b/website/projects/devlog.md
@@ -16,17 +16,12 @@ title: DevLog
 ```                                                                                       
 **DevLog** is a lightweight CLI tool that records your local development workflow. It captures notes, shell activity, and Git actions to produce a structured, timestamped report, perfect for debugging, documentation, or reflection. The logs are recorded in text format via a JSON file. The tool can generate a Markdown and HTML report for developers to directly visualize their workflow offline directly from their browser.
 
-<Badge type="tip" text="Note" />
->
-> More about the idea on this [article](https://listed.to/@Astra/63832/devlog-cli-developer-tool). 
-
----
+> <Badge type="tip" text="Note" /> More about the idea on this [article](https://listed.to/@Astra/63832/devlog-cli-developer-tool). 
 
 ## Features
 
 - 📋 Start and stop sessions via DevLog shell
 - 📝 Add timestamped notes during a session
-- 🎟️ Add timestamped git activity during a session
-- 📂 Export sessions as Markdown and HTML logs
+- 🎟️ Auto log timestamped git activity during a session
+- 📂 Export sessions as Markdown and HTML logs for friendly visual
 - 📁 Organized logs stored in `~/.devlog/sessions/`
-
diff --git a/website/projects/index.md b/website/projects/index.md
@@ -5,15 +5,15 @@ title: Projects
 # 🚀 Projects
 
 Welcome to the **Sandbox Science Projects** section!  
-Here you’ll find our open-source experiments, tools, and collaborative builds.
+Here you’ll find our collaborative open-source experiments.
 
 ## 🤝 How to Contribute
 We love contributions! Whether it’s a small fix or a big feature:
-1. Fork a project 
+1. Fork one of our project
 2. Create your feature branch
 3. Submit a pull request
 
----
+> <Badge type="tip" text="Idea" /> Got a project idea? Pitch it, and let's build it!.
 
 ## 📚 Resources
 - [GitHub Organization](https://github.com/sandbox-science)
