|
| 1 | +# CivicActions GitHub Use Policy |
| 2 | + |
| 3 | +This is a draft policy outlines when work should go into the CivicActions corporate GitHub repository versus a personal repository, and how to attribute CivicActions support when experimenting on paid time. |
| 4 | + |
| 5 | +--- |
| 6 | + |
| 7 | +## 1. Governance: Corporate vs. Personal Repositories |
| 8 | + |
| 9 | +### Corporate GitHub Repository (use when…) |
| 10 | +- The work is **intended to be maintained** beyond the original author’s involvement. |
| 11 | +- The project aligns with **client delivery, internal tooling, or CivicActions strategy**. |
| 12 | +- The code is itended to be **reused, extended, or depended on** by others in the company. |
| 13 | +- The work touches on **governance, compliance, or accessibility** standards where CivicActions must show accountability. |
| 14 | +- Documentation, issue tracking, or contribution from other staff will be needed. |
| 15 | +- Security, licensing, and support responsibilities fall to CivicActions. |
| 16 | + |
| 17 | +### Personal or Private Repositories (use when…) |
| 18 | +- The work is **exploratory, throw-away, or highly experimental**, and may never be maintained. |
| 19 | +- The work is part of **personal learning or prototyping** that doesn’t yet meet company governance standards. |
| 20 | +- The project is tied to **individual interests or experiments** that may or may not align with client work. |
| 21 | +- The author wants to test or draft ideas before proposing them for company adoption. |
| 22 | + |
| 23 | +**Rule of thumb:** If CivicActions or its clients will **depend** on it, it belongs in the corporate repo. If it’s **personal exploration**, keep it in a personal repo unless and until it becomes company-backed. |
| 24 | + |
| 25 | +--- |
| 26 | + |
| 27 | +## 2. Attribution of CivicActions-Supported Work |
| 28 | + |
| 29 | +When staff experiment during CivicActions-paid time, they should acknowledge CivicActions’ support while respecting personal repositories. |
| 30 | + |
| 31 | +- Include a statement in the README of personal repos created on CivicActions time: |
| 32 | + > “This work was initiated with support from CivicActions.” |
| 33 | +- If the project later becomes useful to CivicActions or its clients, it should be **migrated into the corporate GitHub** and maintained under CivicActions governance. |
| 34 | +- Staff are encouraged to **flag experiments** in weekly updates or Slack so others are aware of the exploration, even if it stays in a private repo. |
| 35 | +- When in doubt, **err on the side of attribution**. This protects both the individual and the company and demonstrates CivicActions’ commitment to open knowledge and stewardship. |
| 36 | + |
| 37 | +--- |
| 38 | + |
| 39 | +## 3. Decision Tree |
| 40 | + |
| 41 | +```mermaid |
| 42 | +flowchart TD |
| 43 | + A[Do you expect others at CivicActions to use or depend on this work?] -->|Yes| B[Put it in the Corporate GitHub Repo] |
| 44 | + A -->|No| C[Is this just personal learning or an experiment?] |
| 45 | +
|
| 46 | + C -->|Yes| D[Keep it in a Personal Repo<br/>Add note: 'Supported in part by CivicActions'] |
| 47 | + C -->|No| E[Does it align with client delivery or CivicActions strategy?] |
| 48 | +
|
| 49 | + E -->|Yes| B |
| 50 | + E -->|No| D |
| 51 | +
|
| 52 | + B --> F[Add docs & follow CivicActions governance] |
0 commit comments