From 47cd737bc00079bbfda01d001072b99b7cf5eaaf Mon Sep 17 00:00:00 2001 From: buenosairesam Date: Fri, 2 Jan 2026 22:56:47 -0300 Subject: [PATCH] docs: fix styling and content - Black background instead of blue - Remove 'dev' from build commands - Shorter problem descriptions - Fix missing infrastructure description (DBs, APIs, K8s) --- docs/architecture/index.html | 99 +++++++++++++++++++++++++++--------- docs/architecture/styles.css | 20 +++++--- docs/index.html | 55 +++++++++++++++----- 3 files changed, 131 insertions(+), 43 deletions(-) diff --git a/docs/architecture/index.html b/docs/architecture/index.html index 447b3c6..f485885 100644 --- a/docs/architecture/index.html +++ b/docs/architecture/index.html @@ -9,7 +9,9 @@

Soleprint

-

Cada paso deja huella / Each step leaves a mark

+

+ Cada paso deja huella / Each step leaves a mark +

@@ -19,15 +21,25 @@

Freelance Work Standardization

-

Generalizing and homogenizing freelance work across projects. Instead of setting up different environments, testing approaches, and connector patterns for each client, Soleprint provides a consistent framework. Build once, reuse everywhere.

+

+ Consistent framework across projects. Build once, + reuse everywhere. +

-

Missing Infrastructure Replication

-

When working with large corps where you can't access their Jira, Slack, payment systems, or internal APIs directly - Soleprint's shunts let you mock those systems locally. Test against fake MercadoPago, fake Jira tickets, fake webhooks without needing real credentials.

+

Missing Infrastructure

+

+ Mock systems you can't access yet - DB designs in + progress, Kubernetes not ready, APIs being built. + Test locally with shunts. +

-

Reliable Testing Environment

-

Figure out what tests to write by actually running flows in a controlled environment. BDD -> Gherkin -> Tests workflow. Instead of guessing what to test, you explore the actual behavior first, document it, then generate tests from that documentation.

+

Reliable Testing

+

+ BDD -> Gherkin -> Tests. Explore behavior first, + then generate tests. +

@@ -36,7 +48,9 @@

System Overview

- View Full + View Full
System Overview @@ -45,10 +59,22 @@

The four systems that make up Soleprint.

Systems

    -
  • Soleprint: Core coordinator hub (port 12000)
    • -
  • Artery: Connectors to external services - "Todo lo vital"
    • -
  • Atlas: Actionable documentation - "Documentacion accionable"
    • -
  • Station: Tools and monitors - "Centro de control"
    • +
  • + Soleprint: Core coordinator hub + (port 12000) +
    • +
  • + Artery: Connectors to external + services - "Todo lo vital" +
    • +
  • + Atlas: Actionable documentation - + "Documentacion accionable" +
    • +
  • + Station: Tools and monitors - + "Centro de control" +
@@ -57,9 +83,14 @@

Artery Hierarchy

- View Full + View Full
- + Artery Hierarchy
@@ -103,7 +134,9 @@

Build Flow

- View Full + View Full
Build Flow @@ -120,15 +153,17 @@ - python build.py dev + python build.py gen/standalone/ - python build.py dev --cfg amar + + python build.py --cfg amar + gen/amar/ - python build.py dev --all + python build.py --all both @@ -140,7 +175,9 @@

Room Configuration

- View Full + View Full
Room Configuration @@ -149,10 +186,24 @@

How rooms are configured in cfg/.

Room Structure

    -
  • config.json: Framework branding, terminology
    • -
  • data/: veins.json, shunts.json, depots.json
    • -
  • soleprint/: Docker config for this room
    • -
  • databrowse/, tester/, monitors/, models/: Room-specific extensions
    • +
  • + config.json: Framework branding, + terminology +
    • +
  • + data/: veins.json, shunts.json, + depots.json +
    • +
  • + soleprint/: Docker config for this + room +
    • +
  • + databrowse/, tester/, monitors/, + models/: Room-specific extensions +
@@ -200,7 +251,9 @@

Soleprint - Development Workflow Platform

-

Generated:

+

+ Generated: +

diff --git a/docs/architecture/styles.css b/docs/architecture/styles.css index 4f251b9..c23d754 100644 --- a/docs/architecture/styles.css +++ b/docs/architecture/styles.css @@ -1,12 +1,12 @@ :root { - --bg-primary: #1a1a2e; - --bg-secondary: #16213e; - --bg-card: #0f3460; + --bg-primary: #0a0a0a; + --bg-secondary: #141414; + --bg-card: #1a1a1a; --text-primary: #eee; --text-secondary: #a0a0a0; --accent: #e94560; --accent-secondary: #533483; - --border: #2a2a4a; + --border: #2a2a2a; } * { @@ -16,14 +16,22 @@ } body { - font-family: 'Segoe UI', system-ui, -apple-system, sans-serif; + font-family: + "Segoe UI", + system-ui, + -apple-system, + sans-serif; background: var(--bg-primary); color: var(--text-primary); line-height: 1.6; } header { - background: linear-gradient(135deg, var(--bg-secondary), var(--accent-secondary)); + background: linear-gradient( + 135deg, + var(--bg-secondary), + var(--accent-secondary) + ); padding: 2rem; text-align: center; border-bottom: 2px solid var(--accent); diff --git a/docs/index.html b/docs/index.html index 59e0248..ce08a28 100644 --- a/docs/index.html +++ b/docs/index.html @@ -9,20 +9,36 @@

Soleprint

-

Cada paso deja huella / Each step leaves a mark

+

+ Cada paso deja huella / Each step leaves a mark +

Documentation

- +

Architecture

-

System overview, connector hierarchy, build flow, and room configuration diagrams.

+

+ System overview, connector hierarchy, build flow, + and room configuration diagrams. +

- +

Veins & Shunts

-

API connectors (Jira, Slack, Google) and mock connectors for testing.

+

+ API connectors (Jira, Slack, Google) and mock + connectors for testing. +

@@ -31,16 +47,25 @@

Quick Start

Build & Run

- 
+                    
 # Build standalone
-python build.py dev
+python build.py
 cd gen/standalone && .venv/bin/python run.py
 
 # Build with room config
-python build.py dev --cfg amar
+python build.py --cfg amar
 cd gen/amar && .venv/bin/python run.py
 
-# Visit http://localhost:12000

+# Visit http://localhost:12000
@@ -48,16 +73,18 @@ cd gen/amar && .venv/bin/python run.py

What Soleprint Solves

-

Freelance Work Standardization

-

Consistent framework across projects. Build once, reuse everywhere.

+

Freelance Standardization

+

Consistent framework across projects.

Missing Infrastructure

-

Mock external systems locally when you can't access client infrastructure.

+

+ Mock systems not ready yet - DBs, APIs, Kubernetes. +

-

Testing Environment

-

BDD -> Gherkin -> Tests. Explore behavior first, then generate tests.

+

Reliable Testing

+

BDD -> Gherkin -> Tests.