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 e4e36862f3 docs: remove obsolete archive and migration materials

The ngit-relay migration is complete and archived operational reports and
migration scripts are no longer needed. Remove the entire docs/archive
directory and its documentation links, including older dangling references.

Keep investigation, deployment-check, and soak notes in ignored work/ and
update agent and work-directory instructions to prevent recreating the archive.
Lasting product documentation belongs in the existing Diataxis directories.
This changes no runtime behavior and does not rewrite published history.

Validation: verified the directory is absent, checked tracked documentation
and configuration for archive references, and ran git diff --check. Runtime
tests are unnecessary for documentation and retired-script removal.

Assisted-by: GPT-6

2026-09-24 06:52:36 +00:00

grasp-01-implementation.md

refactor(auth): make current maintainer authority explicit

2026-08-29 21:20:49 +00:00

grasp-audit.md

docs: remove obsolete archive and migration materials

2026-09-24 06:52:36 +00:00

nix-flakes.md

docs: remove obsolete archive and migration materials

2026-09-24 06:52:36 +00:00

nostr-sdk.md

docs: remove obsolete archive and migration materials

2026-09-24 06:52:36 +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.