Skip to content

Commit dc6f91c

Browse files
claudehyperpolymath
authored andcommitted
docs(governance): fill required-file placeholders + fix project naming
Remove unfilled {{PLACEHOLDER}} tokens from governance REQUIRED_FILES and delete the rsr-template TEMPLATE INSTRUCTIONS blocks: - SECURITY.md: drop TEMPLATE INSTRUCTIONS block; replace PGP-key machinery ({{PGP_KEY_URL}}, unset fingerprint) with a no-PGP fallback pointing at GitHub Security Advisories (mirrors quandledb #50/#51); fix wrong-project naming nextgen-languages -> tangle in URLs and prose. - CODE_OF_CONDUCT.md: drop TEMPLATE INSTRUCTIONS block; fill {{CONDUCT_EMAIL}} -> 6759885+hyperpolymath@users.noreply.github.com, {{CONDUCT_TEAM}} -> conduct team, {{RESPONSE_TIME}} -> 5 working days; fix wrong-project naming. - CONTRIBUTING.md: fix wrong-project naming nextgen-languages -> tangle (clone URL, dir names, label URLs). Genuine cross-references (README.adoc ecosystem mention of Nextgen Languages) left intact. Template files (QUICKSTART-*.adoc, contractile/k9 templates) untouched. https://claude.ai/code/session_017TXizM5c1Yd9HWf7Y15YH2
1 parent 71fbca7 commit dc6f91c

3 files changed

Lines changed: 32 additions & 85 deletions

File tree

CODE_OF_CONDUCT.md

Lines changed: 10 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -4,29 +4,9 @@ Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
44
-->
55
# Code of Conduct
66

7-
<!--
8-
============================================================================
9-
TEMPLATE INSTRUCTIONS (delete this block before publishing)
10-
============================================================================
11-
Replace all {{PLACEHOLDER}} values:
12-
Nextgen Languages - Your project name
13-
hyperpolymath - GitHub/GitLab username or org
14-
nextgen-languages - Repository name
15-
{{CONDUCT_EMAIL}} - Email for conduct reports
16-
{{CONDUCT_TEAM}} - Name of conduct team/committee
17-
{{RESPONSE_TIME}} - Initial response SLA (e.g., 48 hours)
18-
2026 - Current year
19-
20-
Review and customise:
21-
- Adjust enforcement ladder for your community size
22-
- Add/remove examples based on your context
23-
- Ensure contact methods work for your team
24-
============================================================================
25-
-->
26-
277
## Our Pledge
288

29-
We as members, contributors, and leaders pledge to make participation in Nextgen Languages a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, colour, religion, or sexual identity and orientation.
9+
We as members, contributors, and leaders pledge to make participation in tangle a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, colour, religion, or sexual identity and orientation.
3010

3111
We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
3212

@@ -140,7 +120,7 @@ If you experience or witness unacceptable behaviour, or have any other concerns,
140120

141121
| Method | Details | Best For |
142122
|--------|---------|----------|
143-
| **Email** | {{CONDUCT_EMAIL}} | Detailed reports, sensitive matters |
123+
| **Email** | 6759885+hyperpolymath@users.noreply.github.com | Detailed reports, sensitive matters |
144124
| **Private Message** | Contact any maintainer directly | Quick questions, minor issues |
145125
| **Anonymous Form** | [Link to form if available] | When you need anonymity |
146126

@@ -156,8 +136,8 @@ If you experience or witness unacceptable behaviour, or have any other concerns,
156136

157137
**What Happens Next**
158138

159-
1. You will receive acknowledgment within **{{RESPONSE_TIME}}**
160-
2. The {{CONDUCT_TEAM}} will review the report
139+
1. You will receive acknowledgment within **5 working days**
140+
2. The conduct team will review the report
161141
3. We may ask for additional information
162142
4. We will determine appropriate action
163143
5. We will inform you of the outcome (respecting others' privacy)
@@ -173,7 +153,7 @@ All reports will be handled with discretion:
173153

174154
### Conflicts of Interest
175155

176-
If a {{CONDUCT_TEAM}} member is involved in an incident:
156+
If a conduct team member is involved in an incident:
177157

178158
- They will recuse themselves from the process
179159
- Another maintainer or external party will handle the report
@@ -183,7 +163,7 @@ If a {{CONDUCT_TEAM}} member is involved in an incident:
183163

184164
## Enforcement Guidelines
185165

186-
The {{CONDUCT_TEAM}} will follow these guidelines in determining consequences:
166+
The conduct team will follow these guidelines in determining consequences:
187167

188168
### 1. Correction
189169

@@ -235,13 +215,13 @@ For contributors with elevated access (Perimeter 2 or 1):
235215
If you believe an enforcement decision was made in error:
236216

237217
1. **Wait 7 days** after the decision (cooling-off period)
238-
2. **Email** {{CONDUCT_EMAIL}} with subject line "Appeal: [Original Report ID]"
218+
2. **Email** 6759885+hyperpolymath@users.noreply.github.com with subject line "Appeal: [Original Report ID]"
239219
3. **Explain** why you believe the decision should be reconsidered
240220
4. **Provide** any new information not previously available
241221

242222
**Appeals Process**
243223

244-
- Appeals are reviewed by a different {{CONDUCT_TEAM}} member than the original
224+
- Appeals are reviewed by a different conduct team member than the original
245225
- You will receive a response within 14 days
246226
- The appeals decision is final
247227
- You may only appeal once per incident
@@ -314,8 +294,8 @@ We thank these communities for their leadership in creating welcoming spaces.
314294

315295
If you have questions about this Code of Conduct:
316296

317-
- Open a [Discussion](https://github.com/hyperpolymath/nextgen-languages/discussions) (for general questions)
318-
- Email {{CONDUCT_EMAIL}} (for private questions)
297+
- Open a [Discussion](https://github.com/hyperpolymath/tangle/discussions) (for general questions)
298+
- Email 6759885+hyperpolymath@users.noreply.github.com (for private questions)
319299
- Contact any maintainer directly
320300

321301
---

CONTRIBUTING.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,15 @@ SPDX-License-Identifier: MPL-2.0
33
Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
44
-->
55
# Clone the repository
6-
git clone https://github.com/hyperpolymath/nextgen-languages.git
7-
cd nextgen-languages
6+
git clone https://github.com/hyperpolymath/tangle.git
7+
cd tangle
88

99
# Using Nix (recommended for reproducibility)
1010
nix develop
1111

1212
# Or using toolbox/distrobox
13-
toolbox create nextgen-languages-dev
14-
toolbox enter nextgen-languages-dev
13+
toolbox create tangle-dev
14+
toolbox enter tangle-dev
1515
# Install dependencies manually
1616

1717
# Verify setup
@@ -21,7 +21,7 @@ just test # Run test suite
2121
2222
### Repository Structure
2323
```
24-
nextgen-languages/
24+
tangle/
2525
├── src/ # Source code (Perimeter 1-2)
2626
├── lib/ # Library code (Perimeter 1-2)
2727
├── extensions/ # Extensions (Perimeter 2)
@@ -90,10 +90,10 @@ Use the [feature request template](.github/ISSUE_TEMPLATE/feature_request.md) an
9090
9191
Look for issues labelled:
9292
93-
- [`good first issue`](https://github.com/hyperpolymath/nextgen-languages/labels/good%20first%20issue) — Simple Perimeter 3 tasks
94-
- [`help wanted`](https://github.com/hyperpolymath/nextgen-languages/labels/help%20wanted) — Community help needed
95-
- [`documentation`](https://github.com/hyperpolymath/nextgen-languages/labels/documentation) — Docs improvements
96-
- [`perimeter-3`](https://github.com/hyperpolymath/nextgen-languages/labels/perimeter-3) — Community sandbox scope
93+
- [`good first issue`](https://github.com/hyperpolymath/tangle/labels/good%20first%20issue) — Simple Perimeter 3 tasks
94+
- [`help wanted`](https://github.com/hyperpolymath/tangle/labels/help%20wanted) — Community help needed
95+
- [`documentation`](https://github.com/hyperpolymath/tangle/labels/documentation) — Docs improvements
96+
- [`perimeter-3`](https://github.com/hyperpolymath/tangle/labels/perimeter-3) — Community sandbox scope
9797
9898
---
9999

SECURITY.md

Lines changed: 13 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -4,24 +4,6 @@ Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
44
-->
55
# Security Policy
66

7-
<!--
8-
============================================================================
9-
TEMPLATE INSTRUCTIONS (delete this block before publishing)
10-
============================================================================
11-
Replace all {{PLACEHOLDER}} values with your information:
12-
Nextgen Languages - Your project name
13-
hyperpolymath - GitHub username or org (e.g., hyperpolymath)
14-
nextgen-languages - Repository name
15-
6759885+hyperpolymath@users.noreply.github.com - Security contact email
16-
[PGP fingerprint not set] - Your PGP key fingerprint (40 chars, no spaces)
17-
{{PGP_KEY_URL}} - URL to your public PGP key
18-
{{WEBSITE}} - Your website/domain
19-
2026 - Current year for copyright
20-
21-
Optional: Remove sections that don't apply (e.g., PGP if you don't use it)
22-
============================================================================
23-
-->
24-
257
We take security seriously. We appreciate your efforts to responsibly disclose vulnerabilities and will make every effort to acknowledge your contributions.
268

279
## Table of Contents
@@ -44,7 +26,7 @@ We take security seriously. We appreciate your efforts to responsibly disclose v
4426

4527
The preferred method for reporting security vulnerabilities is through GitHub's Security Advisory feature:
4628

47-
1. Navigate to [Report a Vulnerability](https://github.com/hyperpolymath/nextgen-languages/security/advisories/new)
29+
1. Navigate to [Report a Vulnerability](https://github.com/hyperpolymath/tangle/security/advisories/new)
4830
2. Click **"Report a vulnerability"**
4931
3. Complete the form with as much detail as possible
5032
4. Submit — we'll receive a private notification
@@ -56,26 +38,12 @@ This method ensures:
5638
- Coordinated disclosure tooling
5739
- Automatic credit when the advisory is published
5840

59-
### Alternative: Encrypted Email
60-
61-
If you cannot use GitHub Security Advisories, you may email us directly:
62-
63-
| | |
64-
|---|---|
65-
| **Email** | 6759885+hyperpolymath@users.noreply.github.com |
66-
| **PGP Key** | [Download Public Key]({{PGP_KEY_URL}}) |
67-
| **Fingerprint** | `[PGP fingerprint not set]` |
41+
### Alternative: Email
6842

69-
```bash
70-
# Import our PGP key
71-
curl -sSL {{PGP_KEY_URL}} | gpg --import
72-
73-
# Verify fingerprint
74-
gpg --fingerprint 6759885+hyperpolymath@users.noreply.github.com
75-
76-
# Encrypt your report
77-
gpg --armor --encrypt --recipient 6759885+hyperpolymath@users.noreply.github.com report.txt
78-
```
43+
If you cannot use GitHub Security Advisories, email us directly at
44+
6759885+hyperpolymath@users.noreply.github.com. No PGP key is currently
45+
published; for an encrypted channel, request one via a GitHub Security
46+
Advisory.
7947

8048
> **⚠️ Important:** Do not report security vulnerabilities through public GitHub issues, pull requests, discussions, or social media.
8149
@@ -207,7 +175,7 @@ If we cannot reach agreement on disclosure timing, we default to 90 days from yo
207175

208176
The following are within scope for security research:
209177

210-
- This repository (`hyperpolymath/nextgen-languages`) and all its code
178+
- This repository (`hyperpolymath/tangle`) and all its code
211179
- Official releases and packages published from this repository
212180
- Documentation that could lead to security issues
213181
- Build and deployment configurations in this repository
@@ -326,7 +294,7 @@ Recognition includes:
326294
To stay informed about security updates:
327295

328296
- **Watch this repository**: Click "Watch" → "Custom" → Select "Security alerts"
329-
- **GitHub Security Advisories**: Published at [Security Advisories](https://github.com/hyperpolymath/nextgen-languages/security/advisories)
297+
- **GitHub Security Advisories**: Published at [Security Advisories](https://github.com/hyperpolymath/tangle/security/advisories)
330298
- **Release notes**: Security fixes noted in [CHANGELOG](CHANGELOG.md)
331299

332300
### Update Policy
@@ -352,7 +320,7 @@ To stay informed about security updates:
352320

353321
## Security Best Practices
354322

355-
When using Nextgen Languages, we recommend:
323+
When using tangle, we recommend:
356324

357325
### General
358326

@@ -374,8 +342,7 @@ When using Nextgen Languages, we recommend:
374342

375343
## Additional Resources
376344

377-
- [Our PGP Public Key]({{PGP_KEY_URL}})
378-
- [Security Advisories](https://github.com/hyperpolymath/nextgen-languages/security/advisories)
345+
- [Security Advisories](https://github.com/hyperpolymath/tangle/security/advisories)
379346
- [Changelog](CHANGELOG.md)
380347
- [Contributing Guidelines](CONTRIBUTING.md)
381348
- [CVE Database](https://cve.mitre.org/)
@@ -387,8 +354,8 @@ When using Nextgen Languages, we recommend:
387354

388355
| Purpose | Contact |
389356
|---------|---------|
390-
| **Security issues** | [Report via GitHub](https://github.com/hyperpolymath/nextgen-languages/security/advisories/new) or 6759885+hyperpolymath@users.noreply.github.com |
391-
| **General questions** | [GitHub Discussions](https://github.com/hyperpolymath/nextgen-languages/discussions) |
357+
| **Security issues** | [Report via GitHub](https://github.com/hyperpolymath/tangle/security/advisories/new) or 6759885+hyperpolymath@users.noreply.github.com |
358+
| **General questions** | [GitHub Discussions](https://github.com/hyperpolymath/tangle/discussions) |
392359
| **Other enquiries** | See [README](README.md) for contact information |
393360

394361
---
@@ -403,7 +370,7 @@ This security policy may be updated from time to time. Significant changes will
403370

404371
---
405372

406-
*Thank you for helping keep Nextgen Languages and its users safe.* 🛡️
373+
*Thank you for helping keep tangle and its users safe.* 🛡️
407374

408375
---
409376

0 commit comments

Comments
 (0)