docs: humanize documentation and update architecture

- content/about.md: Rewrite with first-person voice, remove
  "next-generation" and "craft tools that emphasize" patterns.
  Add personality ("probably more than it should").

- content/collab.md: More direct language, remove "find value in"
  and "broader community" hedging. Shorter bullet lists.

- AGENTS.md: Remove "state-of-the-art", update architecture tree
  to reflect current modules (config, feed, templates), fix
  stale config section to show actual site.toml usage.
This commit is contained in:
Timothy DeHerrera
2026-01-24 22:28:38 -07:00
parent 3a36c2a909
commit a73359098e
4 changed files with 32 additions and 34 deletions

View File

@@ -40,7 +40,7 @@ The agent MUST read and adhere to the global engineering ruleset and any active
- **Suckless:** No bloated runtimes, no unnecessary JavaScript
- **Hermetic:** Single binary with all dependencies compiled in
- **Elegant:** State-of-the-art syntax highlighting via Tree-sitter
- **Elegant:** Syntax highlighting via Tree-sitter
### Architecture
@@ -85,15 +85,17 @@ nix build # Build hermetic release binary
.
├── Cargo.toml # Rust manifest
├── flake.nix # Nix build environment
├── site.toml # Site configuration
├── src/
│ ├── main.rs # Pipeline orchestrator
│ ├── config.rs # TOML config loader
│ ├── feed.rs # Atom feed generation
│ ├── highlight.rs # Tree-sitter highlighting
│ ├── render.rs # Pulldown-cmark interception
│ └── assets.rs # CSS processing
├── queries/ # Tree-sitter S-expression queries
├── content/ # Blog content (Markdown + TOML frontmatter)
── theme/ # Maud templates and CSS
└── deprecated/ # Legacy Zola infrastructure (archived)
│ └── templates.rs # Maud HTML templates
├── content/ # Blog content (Markdown + YAML frontmatter)
├── static/ # CSS, images, _headers
── public/ # Generated output
```
---
@@ -116,12 +118,10 @@ nix build # Build hermetic release binary
## Configuration
Site configuration will be defined in `site.toml` (future):
Site configuration lives in `site.toml`:
```toml
title = "nrd.sh"
author = "nrdxp"
base_url = "https://nrd.sh/"
title = "nrdxp"
# ...
```
Currently using hardcoded defaults during initial development.

View File

@@ -2,13 +2,13 @@
title: About
---
I'm Tim DeHerrera (nrdxp), an engineer at [IOG](https://iog.io) where I help develop interoperable blockchain infrastructure for the Cardano ecosystem.
I'm Tim DeHerrera (nrdxp), an engineer at [IOG](https://iog.io) where I work on blockchain infrastructure for the Cardano ecosystem.
As co-founder of the [Ekala Project](https://github.com/ekala-project), I'm building next-generation tooling for reproducible builds and declarative systems.
I co-founded the [Ekala Project](https://github.com/ekala-project) to build better tooling for reproducible builds and declarative systems.
With a decade of experience in distributed systems, build infrastructure, and network optimization, I craft tools that emphasize reproducibility and determinism. My engineering approach leverages expressive type systems and functional programming paradigms, with current focus on the Rust and Nix ecosystems.
I've spent about a decade working on distributed systems, build infrastructure, and network optimization. I mostly work in Rust and Nix these days, though I'll pick up whatever gets the job done. Reproducibility and determinism matter to me—probably more than they should.
If you're interested in working together, supporting open source, or just want to discuss something interesting, consider [collaborating](/collab) with me or reaching out through any of the social links above.
If any of this sounds interesting, check out the [collab](/collab.html) page or hit me up through the social links above.
## Sigs

View File

@@ -4,34 +4,32 @@ title: Collaborate
## Support Open Source
If you find value in my open-source contributions, there are several ways to support this work:
If my open-source work has helped you, here's how to support it:
- Drop by [Discord](https://discord.gg/DgC9Snxmg7) to say hello and share ideas
- Contribute technically to [Ekala](https://github.com/ekala-project) or other projects
- Support development financially through:
- Drop by [Discord](https://discord.gg/DgC9Snxmg7) to say hi
- Contribute to [Ekala](https://github.com/ekala-project) or other projects
- Throw some money at it:
**Fiat Contributions**
**Fiat**
- [Personal Liberapay](https://liberapay.com/nrdxp/donate)
- [Ekala Liberapay](https://liberapay.com/Ekala/donate)
**Crypto Contributions**
**Crypto**
- BTC: [bc1qqwlhvtza3az3vj0um03yqrsqnl32gfdgz7x96s](bitcoin:bc1qqwlhvtza3az3vj0um03yqrsqnl32gfdgz7x96s)
- ETH: [0x131b30f34b9F120b4C08c987150B4e83581e3FD5](ethereum:0x131b30f34b9F120b4C08c987150B4e83581e3FD5)
- ADA: [$nrdxp](cardano:addr1qywsmj6rph5xp4g0mfgnee6hwfk4l6ark42k8x0lfklah9akeej0wlqxpxwcucmrjm8gt3c3pa9tpejkzcsgaxflym4qrglkmw)
## Contract Work
I'm available for consulting and contract work specializing in:
I take on consulting and contract work. My areas:
- Distributed systems architecture
- Build infrastructure optimization
- Rust and Nix ecosystem development
- Blockchain infrastructure engineering
- General systems programming and tooling
- Other interesting technical challenges
- Distributed systems
- Build infrastructure
- Rust and Nix
- Blockchain infrastructure
- General systems programming
- Interesting problems (try me)
## Get in Touch
For contract work inquiries or to discuss potential collaborations, reach out through any of my social links above. I'm happy to sit down and explore how we can work together on your next project.
Your contribution, whether through direct hiring or open-source support, helps maintain and improve tools used by the broader community. Thank you!
For contract work or collaboration, reach out through my social links. Happy to talk through your project.

View File

@@ -1,11 +1,11 @@
# Netlify build configuration for nrd.sh
[build]
command = "cargo build --release && ./target/release/nrd-sh"
publish = "public"
command = "cargo build --release && ./target/release/nrd-sh"
publish = "public"
[build.environment]
RUST_VERSION = "1.84"
RUST_VERSION = "1.84"
# Redirect clean URLs (optional, for server-side routing)
# Not needed since we use .html extensions