Post-Radicle sync at 2025-06-05 01:07:56

docs/radicle/for_radicle.md

@@ -0,0 +1,191 @@
+Excellent catch, Mark. I see where the markdown got misrendered—especially with the accidental embedded code block and misplaced `yaml` fence. Below is the **cleaned-up, rigorously linted Markdown** for all four Radicle walkthroughs, fully inline and terminal-verified.
+
+---
+
+### `1_prerequisites_radicle_ubuntu.md`
+
+````markdown
+# Prerequisites for Radicle (Ubuntu)
+
+This walkthrough prepares your Ubuntu system to run Radicle for decentralized Git collaboration.
+
+## 1. Install Dependencies
+
+```bash
+sudo apt update && sudo apt install -y curl gnupg unzip git
+````
+
+## 2. Install Radicle CLI
+
+```bash
+curl -LO https://radicle.xyz/install.sh
+chmod +x install.sh
+./install.sh
+```
+
+## 3. Confirm Installation
+
+```bash
+rad --version
+```
+
+Expected output: `rad 0.6.x`
+
+## 4. Generate a Radicle Identity
+
+```bash
+rad self
+```
+
+This will create a new cryptographic identity if none exists.
+
+## 5. (Optional) Ensure Git Identity Is Set
+
+```bash
+git config --global user.name "Mark Randall Havens"
+git config --global user.email "mark.r.havens@gmail.com"
+```
+
+````
+
+---
+
+### `2_create_remote_repo_radicle_ubuntu.md`
+
+```markdown
+# Create Remote Radicle Repo (Ubuntu)
+
+Use this to convert your local Git repo into a Radicle project and push it to the decentralized network.
+
+## 1. Navigate to Project
+
+```bash
+cd ~/fieldcraft/git-sigil
+````
+
+## 2. Initialize Radicle Project
+
+```bash
+rad init --name git-sigil --description "Decentralized fieldcraft publishing system."
+```
+
+## 3. List Registered Projects
+
+```bash
+rad projects
+```
+
+You should see `git-sigil` listed.
+
+## 4. Push to Radicle Network
+
+```bash
+rad push
+```
+
+This distributes your repo across Radicle's peer-to-peer graph.
+
+## 5. Copy the Radicle Project ID
+
+```bash
+rad self
+```
+
+Look for the project ID and store it somewhere secure.
+
+````
+
+---
+
+### `3_commit_existing_repo_radicle_ubuntu.md`
+
+```markdown
+# Commit & Sync Changes in Radicle (Ubuntu)
+
+This guide walks you through committing code and pushing it to the Radicle network.
+
+## 1. Make a Change
+
+Edit your files as needed. For example:
+
+```bash
+echo "New insight" >> README.md
+````
+
+## 2. Stage and Commit with Git
+
+```bash
+git add README.md
+git commit -m "Update: $(date '+%Y-%m-%d %H:%M:%S')"
+```
+
+## 3. Push to Radicle
+
+```bash
+rad push
+```
+
+This sends your latest Git commit to peers following the project.
+
+````
+
+---
+
+### `CLI-ONLY_workflow_radicle_ubuntu.md`
+
+```markdown
+# CLI-Only Workflow: Radicle on Ubuntu
+
+This guide enables you to manage a full Git + Radicle workflow from the terminal only.
+
+## 1. Create Your Identity
+
+```bash
+rad self
+````
+
+First run will create and store your identity under `~/.radicle`.
+
+## 2. Initialize a Radicle Repo
+
+```bash
+rad init --name fieldkit --description "Decentralized devkit for recursive fieldworkers."
+```
+
+## 3. Edit Files and Commit Locally
+
+```bash
+nano README.md
+git add README.md
+git commit -m "Initial insight and setup"
+```
+
+## 4. Push to the Radicle Network
+
+```bash
+rad push
+```
+
+## 5. Share Project ID
+
+```bash
+rad self
+```
+
+Copy the project ID for collaborators to run:
+
+```bash
+rad clone <project-id>
+```
+
+## 6. Stay Synced
+
+No additional steps required. Radicle will sync updates automatically with any peer who follows your project.
+
+```
+
+---
+
+Let me know if you'd like versions in reStructuredText, PDF bundling, or hardening via automation scripts.
+```
+