laantungir/ngit-grasp

Fork 0

mirror of https://relay.ngit.dev/npub15qydau2hjma6ngxkl2cyar74wzyjshvl65za5k5rl69264ar2exs5cyejr/ngit-grasp.git synced 2026-10-05 15:08:24 +00:00

Files

T

History

DanConwayDev 51751d59f3 Change default port from 8080 to 7334 (NGIT on phone keypad)

- Update default bind address in src/config.rs to 127.0.0.1:7334
- Update all four critical config sources per AGENTS.md:
  - src/config.rs (code default and tests)
  - .env.example (development template)
  - docs/reference/configuration.md (user documentation)
  - nix/module.nix (NixOS deployment)
- Update all documentation examples and references:
  - README.md (with note about phone keypad mnemonic)
  - docs/how-to/*.md (deploy, prometheus-setup, test-compliance)
  - docs/explanation/*.md (architecture, comparison)
  - docs/learnings/grasp-audit.md

Port 7334 spells NGIT on a phone keypad, making it memorable and
project-specific.

All tests pass (336 lib tests + 51 integration tests).

2026-01-12 22:51:43 +00:00

grasp-01-implementation.md

feat: add uploadpack.allowFilter support for GRASP-01 compliance

2026-01-12 14:05:51 +00:00

grasp-audit.md

Change default port from 8080 to 7334 (NGIT on phone keypad)

2026-01-12 22:51:43 +00:00

nix-flakes.md

docs: major cleanup and reorganization

2025-11-04 09:31:57 +00:00

nostr-sdk.md

docs: major cleanup and reorganization

2025-11-04 09:31:57 +00:00

README.md

docs: use Diátaxis structure

2025-11-04 10:25:53 +00:00

README.md

Learnings Directory - DEPRECATED

Status: This directory is deprecated as of November 4, 2025.

What Happened?

We migrated to the Diátaxis documentation framework, which provides a clearer structure based on content purpose rather than origin.

Where Did Content Go?

The "learnings" were distributed into appropriate Diátaxis categories:

Gotchas and Patterns → How-To Guides

nix-flakes.md → docs/how-to/nix-flakes.md
Task-oriented solutions to common problems

Technical Details → Reference

nostr-sdk.md → docs/reference/nostr-sdk-upgrade.md (planned)
git-http-backend.md → docs/reference/git-protocol.md
Factual technical information

Concepts and Understanding → Explanation

grasp-audit.md → Incorporated into docs/explanation/architecture.md
Discussion of design and architecture

Why the Change?

The "learnings" category was ambiguous:

Mixed gotchas, patterns, and concepts
Unclear where to put new content
Hard for readers to know what to expect

Diátaxis provides clear categories:

Tutorials - Learning by doing
How-To - Solving problems
Reference - Looking up facts
Explanation - Understanding concepts

See docs/README.md for the new structure.

For Content Authors

Don't create new files here. Instead, ask:

"Can you teach me to...?" → docs/tutorials/
"How do I...?" → docs/how-to/
"What is...?" → docs/reference/
"Why...?" → docs/explanation/

Migration Status

✅ nix-flakes.md → Migrated to how-to/nix-flakes.md
⏳ nostr-sdk.md → Being incorporated into reference docs
✅ grasp-audit.md → Content in explanation/architecture.md

This directory will be removed in a future cleanup.
See AGENTS.md for documentation guidelines.