Skip to content

Commit de00396

Browse files
committed
chore(gitignore): track .kiro/references/research.md while ignoring repos
Narrow ignore to .kiro/references/** but explicitly unignore the path and its research.md so we can commit the synthesized notes.
1 parent 7da98c3 commit de00396

File tree

2 files changed

+54
-1
lines changed

2 files changed

+54
-1
lines changed

.gitignore

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -176,4 +176,10 @@ coverage/
176176

177177
# Local development overrides
178178
docker-compose.override.yml
179-
local.env
179+
local.env
180+
181+
# Ignore references mirror by default, but keep research notes tracked
182+
.kiro/references/**
183+
!.kiro/
184+
!.kiro/references/
185+
!.kiro/references/research.md

.kiro/references/research.md

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,53 @@ These are consolidated notes from the repos cloned into `.kiro/references/`. Foc
5858
- webring/, tildes/, where/, www-site, www-site-v2, wiki/: Site scaffolds, static content, security policy pages, wiki structures and templates.
5959
- Transferable: include security policy and a simple wiki template.
6060

61+
- tilde.tk/: Tilde subdomain project details (Cloudflare Pages hosting, Freenom registrar); manual email-based onboarding; TODOs for automation.
62+
- Transferable: if offering subdomains, automate DNS provisioning and onboarding emails.
63+
64+
- tilde/ (Hack Club tilde NixOS config): Flake-based host config, `addusr` script for creating required directories, strict CoC; services limited to static HTTP/Gemini; joining via Slack `#tilde` with SSH key.
65+
- Transferable: NixOS flake as an alternative ops stack; ensure `addusr`-like script in our provisioning.
66+
67+
- tildetown_ring/: Python/JS/Prolog web ring for tilde.town with join page.
68+
- Transferable: another webring implementation to study for join workflows.
69+
70+
- tilde-social/: Flat-file social network under `~/.social` with CLI `timeline` for feeds, posts, and follows; future roadmap includes replies/boosts/hashtags.
71+
- Transferable: consider optional CLI social tooling reading from home dirs; or integrate with our `comm` endpoints.
72+
73+
- tilde.etcskel/: `/etc/skel` contents and contribution model; encourages wiki-driven docs.
74+
- Transferable: ship a curated `/etc/skel` with helpful defaults.
75+
76+
- share/: Placeholder for shared assets; no substantive docs here.
77+
78+
- site/ and site/wiki/: tilde.club site source and wiki build flow; contributors submit markdown, `make` builds HTML; signup code reference included.
79+
- Transferable: keep site build simple, accept PRs for docs/wiki.
80+
81+
- tilde.club/: Code and utilities for running/managing tilde.club; community ethos and links to story/FAQ; volunteer-led model.
82+
- Transferable: emphasize volunteer onboarding and clear contribution channels.
83+
84+
- spsrv/: Spartan protocol server in Go with features: `/~user` support, directory listing, CGI, CONF/TOML config, systemd examples; caution around user CGI security.
85+
- Transferable: if offering Spartan/Gemini, consider spsrv; document CGI risks and sandboxing.
86+
87+
- webring/: XXIIVV webring with criteria and circular linking; requires 10+ content pages and a banner; join via PR to `index.html`.
88+
- Transferable: adopt quality criteria for our webring.
89+
90+
- tildes/: utilities for tildeverse (e.g., `code` to index user dirs into HTML).
91+
- Transferable: provide admin scripts to generate community indices (opt-in).
92+
93+
- where/: rewritten tool (Tcl + SQLite) to geolocate/where listing; caches IPs.
94+
- Transferable: pattern for lightweight service with caching.
95+
96+
- www-site/ and www-site-v2/: Dimension.sh website (Hugo in v2).
97+
- Transferable: Hugo is a good default for static sites.
98+
99+
- wiki/: Dimension.sh wiki markdown and style guide (WikiLinks, archival links).
100+
- Transferable: adopt WikiLinks-style internal linking.
101+
102+
- tildejsongen/: Python tool to generate Tilde Description Protocol `tilde.json`/yaml from INI config; outputs paths, users group id, signup URL, want_users flag.
103+
- Transferable: auto-publish our `tilde.json` and `tilde.yaml` to advertise services.
104+
105+
- website/: Project Segfault Svelte site; dev/prod instructions; envs for Ghost CMS and Uptime Kuma; Docker-first deploy.
106+
- Transferable: reference for integrating status/news feeds into our public site.
107+
61108
## Provisioning and user lifecycle
62109

63110
- mkuser (Python CLI):

0 commit comments

Comments
 (0)