docs: fix styling and content
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful

- Black background instead of blue
- Remove 'dev' from build commands
- Shorter problem descriptions
- Fix missing infrastructure description (DBs, APIs, K8s)
This commit is contained in:
buenosairesam
2026-01-02 22:56:47 -03:00
parent 22356fed66
commit 47cd737bc0
3 changed files with 131 additions and 43 deletions

View File

@@ -9,20 +9,36 @@
<body>
<header>
<h1>Soleprint</h1>
<p class="subtitle">Cada paso deja huella / Each step leaves a mark</p>
<p class="subtitle">
Cada paso deja huella / Each step leaves a mark
</p>
</header>
<main>
<section class="findings-section">
<h2>Documentation</h2>
<div class="findings-grid">
<a href="architecture/index.html" class="finding-card" style="text-decoration: none;">
<a
href="architecture/index.html"
class="finding-card"
style="text-decoration: none"
>
<h3>Architecture</h3>
<p>System overview, connector hierarchy, build flow, and room configuration diagrams.</p>
<p>
System overview, connector hierarchy, build flow,
and room configuration diagrams.
</p>
</a>
<a href="veins/index.html" class="finding-card" style="text-decoration: none;">
<a
href="veins/index.html"
class="finding-card"
style="text-decoration: none"
>
<h3>Veins & Shunts</h3>
<p>API connectors (Jira, Slack, Google) and mock connectors for testing.</p>
<p>
API connectors (Jira, Slack, Google) and mock
connectors for testing.
</p>
</a>
</div>
</section>
@@ -31,16 +47,25 @@
<h2>Quick Start</h2>
<div class="finding-card">
<h3>Build & Run</h3>
<pre style="background: var(--bg-primary); padding: 1rem; border-radius: 4px; overflow-x: auto; margin-top: 0.5rem;">
<pre
style="
background: var(--bg-primary);
padding: 1rem;
border-radius: 4px;
overflow-x: auto;
margin-top: 0.5rem;
"
>
# 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</pre>
# Visit http://localhost:12000</pre
>
</div>
</section>
@@ -48,16 +73,18 @@ cd gen/amar && .venv/bin/python run.py
<h2>What Soleprint Solves</h2>
<div class="findings-grid">
<article class="finding-card">
<h3>Freelance Work Standardization</h3>
<p>Consistent framework across projects. Build once, reuse everywhere.</p>
<h3>Freelance Standardization</h3>
<p>Consistent framework across projects.</p>
</article>
<article class="finding-card">
<h3>Missing Infrastructure</h3>
<p>Mock external systems locally when you can't access client infrastructure.</p>
<p>
Mock systems not ready yet - DBs, APIs, Kubernetes.
</p>
</article>
<article class="finding-card">
<h3>Testing Environment</h3>
<p>BDD -> Gherkin -> Tests. Explore behavior first, then generate tests.</p>
<h3>Reliable Testing</h3>
<p>BDD -> Gherkin -> Tests.</p>
</article>
</div>
</section>