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:
22
AGENTS.md
22
AGENTS.md
@@ -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
|
- **Suckless:** No bloated runtimes, no unnecessary JavaScript
|
||||||
- **Hermetic:** Single binary with all dependencies compiled in
|
- **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
|
### Architecture
|
||||||
|
|
||||||
@@ -85,15 +85,17 @@ nix build # Build hermetic release binary
|
|||||||
.
|
.
|
||||||
├── Cargo.toml # Rust manifest
|
├── Cargo.toml # Rust manifest
|
||||||
├── flake.nix # Nix build environment
|
├── flake.nix # Nix build environment
|
||||||
|
├── site.toml # Site configuration
|
||||||
├── src/
|
├── src/
|
||||||
│ ├── main.rs # Pipeline orchestrator
|
│ ├── main.rs # Pipeline orchestrator
|
||||||
|
│ ├── config.rs # TOML config loader
|
||||||
|
│ ├── feed.rs # Atom feed generation
|
||||||
│ ├── highlight.rs # Tree-sitter highlighting
|
│ ├── highlight.rs # Tree-sitter highlighting
|
||||||
│ ├── render.rs # Pulldown-cmark interception
|
│ ├── render.rs # Pulldown-cmark interception
|
||||||
│ └── assets.rs # CSS processing
|
│ └── templates.rs # Maud HTML templates
|
||||||
├── queries/ # Tree-sitter S-expression queries
|
├── content/ # Blog content (Markdown + YAML frontmatter)
|
||||||
├── content/ # Blog content (Markdown + TOML frontmatter)
|
├── static/ # CSS, images, _headers
|
||||||
├── theme/ # Maud templates and CSS
|
└── public/ # Generated output
|
||||||
└── deprecated/ # Legacy Zola infrastructure (archived)
|
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -116,12 +118,10 @@ nix build # Build hermetic release binary
|
|||||||
|
|
||||||
## Configuration
|
## Configuration
|
||||||
|
|
||||||
Site configuration will be defined in `site.toml` (future):
|
Site configuration lives in `site.toml`:
|
||||||
|
|
||||||
```toml
|
```toml
|
||||||
|
title = "nrd.sh"
|
||||||
|
author = "nrdxp"
|
||||||
base_url = "https://nrd.sh/"
|
base_url = "https://nrd.sh/"
|
||||||
title = "nrdxp"
|
|
||||||
# ...
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Currently using hardcoded defaults during initial development.
|
|
||||||
|
|||||||
@@ -2,13 +2,13 @@
|
|||||||
title: About
|
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
|
## Sigs
|
||||||
|
|
||||||
|
|||||||
@@ -4,34 +4,32 @@ title: Collaborate
|
|||||||
|
|
||||||
## Support Open Source
|
## 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
|
- Drop by [Discord](https://discord.gg/DgC9Snxmg7) to say hi
|
||||||
- Contribute technically to [Ekala](https://github.com/ekala-project) or other projects
|
- Contribute to [Ekala](https://github.com/ekala-project) or other projects
|
||||||
- Support development financially through:
|
- Throw some money at it:
|
||||||
|
|
||||||
**Fiat Contributions**
|
**Fiat**
|
||||||
- [Personal Liberapay](https://liberapay.com/nrdxp/donate)
|
- [Personal Liberapay](https://liberapay.com/nrdxp/donate)
|
||||||
- [Ekala Liberapay](https://liberapay.com/Ekala/donate)
|
- [Ekala Liberapay](https://liberapay.com/Ekala/donate)
|
||||||
|
|
||||||
**Crypto Contributions**
|
**Crypto**
|
||||||
- BTC: [bc1qqwlhvtza3az3vj0um03yqrsqnl32gfdgz7x96s](bitcoin:bc1qqwlhvtza3az3vj0um03yqrsqnl32gfdgz7x96s)
|
- BTC: [bc1qqwlhvtza3az3vj0um03yqrsqnl32gfdgz7x96s](bitcoin:bc1qqwlhvtza3az3vj0um03yqrsqnl32gfdgz7x96s)
|
||||||
- ETH: [0x131b30f34b9F120b4C08c987150B4e83581e3FD5](ethereum:0x131b30f34b9F120b4C08c987150B4e83581e3FD5)
|
- ETH: [0x131b30f34b9F120b4C08c987150B4e83581e3FD5](ethereum:0x131b30f34b9F120b4C08c987150B4e83581e3FD5)
|
||||||
- ADA: [$nrdxp](cardano:addr1qywsmj6rph5xp4g0mfgnee6hwfk4l6ark42k8x0lfklah9akeej0wlqxpxwcucmrjm8gt3c3pa9tpejkzcsgaxflym4qrglkmw)
|
- ADA: [$nrdxp](cardano:addr1qywsmj6rph5xp4g0mfgnee6hwfk4l6ark42k8x0lfklah9akeej0wlqxpxwcucmrjm8gt3c3pa9tpejkzcsgaxflym4qrglkmw)
|
||||||
|
|
||||||
## Contract Work
|
## Contract Work
|
||||||
|
|
||||||
I'm available for consulting and contract work specializing in:
|
I take on consulting and contract work. My areas:
|
||||||
|
|
||||||
- Distributed systems architecture
|
- Distributed systems
|
||||||
- Build infrastructure optimization
|
- Build infrastructure
|
||||||
- Rust and Nix ecosystem development
|
- Rust and Nix
|
||||||
- Blockchain infrastructure engineering
|
- Blockchain infrastructure
|
||||||
- General systems programming and tooling
|
- General systems programming
|
||||||
- Other interesting technical challenges
|
- Interesting problems (try me)
|
||||||
|
|
||||||
## Get in Touch
|
## 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.
|
For contract work or collaboration, reach out through my social links. Happy to talk through your project.
|
||||||
|
|
||||||
Your contribution, whether through direct hiring or open-source support, helps maintain and improve tools used by the broader community. Thank you!
|
|
||||||
|
|||||||
Reference in New Issue
Block a user