Skip to content

Commit 8803dac

Browse files
ericyangpanclaude
andcommitted
docs: add community governance and contribution guidelines
Add comprehensive community documentation including Code of Conduct, contributing guidelines, security policy, and GitHub templates for issues and pull requests. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
1 parent b848054 commit 8803dac

17 files changed

+2479
-0
lines changed

.github/CODEOWNERS

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# CODEOWNERS file for AI Coding Stack
2+
# This file defines who should review pull requests for specific parts of the codebase.
3+
#
4+
# Syntax: path/pattern @username @team
5+
# Lines are matched from top to bottom, last match wins.
6+
#
7+
# Learn more: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
8+
9+
# Default owners for everything in the repo
10+
# TODO: Replace with actual GitHub usernames of maintainers
11+
* @aicodingstack/maintainers
12+
13+
# Manifest files - require review from maintainers
14+
# This is the most important contribution area
15+
/manifests/**/*.json @aicodingstack/maintainers
16+
17+
# Schema files - require careful review as they affect validation
18+
/manifests/schemas/**/*.json @aicodingstack/maintainers
19+
20+
# Build and validation scripts - require careful review
21+
/scripts/**/*.mjs @aicodingstack/maintainers
22+
23+
# GitHub Actions workflows - require review for security
24+
/.github/workflows/**/*.yml @aicodingstack/maintainers
25+
26+
# Configuration files
27+
/package.json @aicodingstack/maintainers
28+
/tsconfig.json @aicodingstack/maintainers
29+
/next.config.mjs @aicodingstack/maintainers
30+
/wrangler.toml @aicodingstack/maintainers
31+
32+
# Documentation - can be reviewed by broader team
33+
/docs/**/*.md @aicodingstack/maintainers
34+
/README.md @aicodingstack/maintainers
35+
/CONTRIBUTING.md @aicodingstack/maintainers
36+
37+
# Application code - reviewed by maintainers
38+
/src/**/*.ts @aicodingstack/maintainers
39+
/src/**/*.tsx @aicodingstack/maintainers
40+
41+
# Content files (MDX) - can be reviewed by content team
42+
/content/**/*.mdx @aicodingstack/maintainers
Lines changed: 129 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,129 @@
1+
name: Bug Report
2+
description: Report a bug or issue with the AI Coding Stack website
3+
title: "[Bug]: "
4+
labels: ["bug", "needs-triage"]
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
Thanks for taking the time to report a bug! Please provide as much detail as possible to help us resolve the issue quickly.
10+
11+
- type: textarea
12+
id: bug-description
13+
attributes:
14+
label: Bug Description
15+
description: A clear and concise description of what the bug is
16+
placeholder: What went wrong?
17+
validations:
18+
required: true
19+
20+
- type: textarea
21+
id: steps-to-reproduce
22+
attributes:
23+
label: Steps to Reproduce
24+
description: Steps to reproduce the behavior
25+
placeholder: |
26+
1. Go to '...'
27+
2. Click on '...'
28+
3. Scroll down to '...'
29+
4. See error
30+
validations:
31+
required: true
32+
33+
- type: textarea
34+
id: expected-behavior
35+
attributes:
36+
label: Expected Behavior
37+
description: What did you expect to happen?
38+
placeholder: Describe what you expected to see
39+
40+
- type: textarea
41+
id: actual-behavior
42+
attributes:
43+
label: Actual Behavior
44+
description: What actually happened?
45+
placeholder: Describe what actually happened
46+
47+
- type: dropdown
48+
id: severity
49+
attributes:
50+
label: Severity
51+
description: How severe is this bug?
52+
options:
53+
- Low - Minor issue, workaround available
54+
- Medium - Affects functionality but not critical
55+
- High - Major functionality broken
56+
- Critical - Site is unusable
57+
validations:
58+
required: true
59+
60+
- type: input
61+
id: url
62+
attributes:
63+
label: Affected URL
64+
description: Which page is affected?
65+
placeholder: https://aicodingstack.io/...
66+
67+
- type: dropdown
68+
id: browser
69+
attributes:
70+
label: Browser
71+
description: Which browser are you using?
72+
options:
73+
- Chrome
74+
- Firefox
75+
- Safari
76+
- Edge
77+
- Other
78+
79+
- type: input
80+
id: browser-version
81+
attributes:
82+
label: Browser Version
83+
description: What version of the browser?
84+
placeholder: e.g., Chrome 120.0.6099.109
85+
86+
- type: dropdown
87+
id: device
88+
attributes:
89+
label: Device
90+
description: What device are you using?
91+
options:
92+
- Desktop (Windows)
93+
- Desktop (macOS)
94+
- Desktop (Linux)
95+
- Mobile (iOS)
96+
- Mobile (Android)
97+
- Tablet
98+
99+
- type: textarea
100+
id: screenshots
101+
attributes:
102+
label: Screenshots
103+
description: If applicable, add screenshots to help explain the problem
104+
placeholder: Drag and drop images here or paste image URLs
105+
106+
- type: textarea
107+
id: console-errors
108+
attributes:
109+
label: Browser Console Errors
110+
description: Any errors in the browser console? (F12 → Console tab)
111+
placeholder: Paste any error messages here
112+
render: shell
113+
114+
- type: textarea
115+
id: additional-context
116+
attributes:
117+
label: Additional Context
118+
description: Any other context about the problem
119+
placeholder: Add any other information that might help
120+
121+
- type: checkboxes
122+
id: checklist
123+
attributes:
124+
label: Pre-submission Checklist
125+
options:
126+
- label: I have searched for similar issues and this is not a duplicate
127+
required: true
128+
- label: I have provided all the requested information
129+
required: true

.github/ISSUE_TEMPLATE/config.yml

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
blank_issues_enabled: false
2+
contact_links:
3+
- name: GitHub Discussions
4+
url: https://github.com/aicodingstack/aicodingstack.io/discussions
5+
about: Ask questions and discuss ideas with the community
6+
- name: Documentation
7+
url: https://github.com/aicodingstack/aicodingstack.io/blob/main/docs
8+
about: Read the technical documentation
9+
- name: Schema Documentation
10+
url: https://github.com/aicodingstack/aicodingstack.io/tree/main/manifests/schemas
11+
about: View JSON schema documentation for manifests
Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
name: Feature Request
2+
description: Suggest a new feature or enhancement for AI Coding Stack
3+
title: "[Feature]: "
4+
labels: ["enhancement", "needs-triage"]
5+
body:
6+
- type: markdown
7+
attributes:
8+
value: |
9+
Thanks for your interest in improving AI Coding Stack! We appreciate your ideas for new features.
10+
11+
- type: dropdown
12+
id: feature-type
13+
attributes:
14+
label: Feature Type
15+
description: What type of feature are you requesting?
16+
options:
17+
- New website functionality
18+
- Improvement to existing feature
19+
- New data/metadata field
20+
- Better search/filter capabilities
21+
- UI/UX enhancement
22+
- Performance improvement
23+
- Other
24+
validations:
25+
required: true
26+
27+
- type: textarea
28+
id: problem
29+
attributes:
30+
label: Problem Statement
31+
description: Is your feature request related to a problem? Please describe.
32+
placeholder: I'm frustrated when... / It would be helpful if...
33+
validations:
34+
required: true
35+
36+
- type: textarea
37+
id: solution
38+
attributes:
39+
label: Proposed Solution
40+
description: Describe the solution you'd like
41+
placeholder: A clear and concise description of what you want to happen
42+
validations:
43+
required: true
44+
45+
- type: textarea
46+
id: alternatives
47+
attributes:
48+
label: Alternatives Considered
49+
description: Describe any alternative solutions or features you've considered
50+
placeholder: What other approaches could work?
51+
52+
- type: dropdown
53+
id: priority
54+
attributes:
55+
label: Priority
56+
description: How important is this feature to you?
57+
options:
58+
- Nice to have
59+
- Would improve my experience
60+
- Important for my use case
61+
- Critical functionality
62+
validations:
63+
required: true
64+
65+
- type: textarea
66+
id: use-case
67+
attributes:
68+
label: Use Case
69+
description: Describe your specific use case for this feature
70+
placeholder: |
71+
Who would benefit from this feature?
72+
How would you use it?
73+
What problem does it solve?
74+
75+
- type: textarea
76+
id: mockups
77+
attributes:
78+
label: Mockups or Examples
79+
description: If applicable, add mockups, sketches, or examples from other sites
80+
placeholder: Drag and drop images here or paste links to similar features
81+
82+
- type: textarea
83+
id: additional-context
84+
attributes:
85+
label: Additional Context
86+
description: Add any other context or information about the feature request
87+
placeholder: Any other details that might help
88+
89+
- type: checkboxes
90+
id: checklist
91+
attributes:
92+
label: Pre-submission Checklist
93+
options:
94+
- label: I have searched for similar feature requests and this is not a duplicate
95+
required: true
96+
- label: This feature aligns with the project's goals
97+
required: true

0 commit comments

Comments
 (0)