braxton-bell

Documentation System

This is a portable brief on how this repository structures its plans, documentation, and readmes. It describes the system generically so it can seed any project; nothing below depends on this site, its stack, or its tooling. The goal of the system is that the repository is the project's memory. A contributor, an agent, or the owner returning after six months can resume work from the files alone, with no dependence on chat history or anyone's recollection.

The three layers

The system has three layers plus an overflow file.

1. A ./README.md orientation file at the repository root tells a newcomer what the repository is, the rules that must never be broken, and where everything lives. In an agent-driven repository this is the agent instruction file; in a conventional one it is the root README or CONTRIBUTING file.
2. A docs/ folder holds the durable documentation: how each subsystem works and why it is shaped that way, how recurring processes run, and what was decided.

braxton-bell

Installing Private Python Packages via git+https

Install Python packages from private Git repositories using uv or pip without leaking tokens into URLs, shell history, or package metadata.

Why Not Inline Tokens?

Embedding a PAT directly in the URL (git+https://<token>@github.com/...) works, but the token gets persisted in:

• direct_url.json inside the installed package's .dist-info/
• uv's tool receipts (~/.local/share/uv/tools/)

braxton-bell

🪵 PowerShell Tree View (Clean Output, Excluding __pycache__ and .venv)

A quick way to display a clean, ASCII-style tree view of your project in PowerShell — no file attributes, just folder/file hierarchy — while excluding unwanted directories and patterns like __pycache__, .venv, and *.pyc.

📦 Install PSTree

Install-Module PSTree -Scope CurrentUser

braxton-bell

How to Interact with Shadow DOM Elements: A Developer’s Guide to Automation

This article presents is a comprehensive guide on how to extract the path to Shadow DOM elements (the “shadow path”) and then use that path to interact with those elements—whether that’s setting values, firing events, or clicking buttons. We’ll walk through:

1. Why Shadow DOM poses unique challenges for automation.
2. How to generate a shadow path for nested elements.
3. Why setting values and clicking buttons in Shadow DOM sometimes fails if done “the usual way.”
4. A working solution that shows how to properly set values on custom elements, trigger events, and click buttons.

Use this article both to understand the concepts and to train a GPT bot or any developer on the intricacies of Shadow DOM automation.

braxton-bell

How to Configure SQL Server Express in Docker

See: Docker Express: Running a local SQL Server Express | by Maarten Merken | Agilix | Medium

1. Start Container:

   docker run -e "ACCEPT_EULA=Y" `
   -e "MSSQL_SA_PASSWORD=MyPass@word" `
   -e "MSSQL_PID=Express" `
   -p 1433:1433 `

braxton-bell

How-To: Use Multiple Git Accounts on the Same Device

Using HTTPS with Personal Access Token

Reference: GitHub article

---

1. Create a Personal Access Token on GitHub

1. Navigate to GitHub Personal Access Tokens: