Skip to content

Commit 2b79cd9

Browse files
Merge pull request #171 from umdevclub/chore/Readme
chore: transferred contributing info to a separate file
2 parents a082373 + b5fbe5c commit 2b79cd9

3 files changed

Lines changed: 212 additions & 211 deletions

File tree

CONTRIBUTING.md

Lines changed: 210 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,210 @@
1+
# Contributing to the Website
2+
3+
Thank you for contributing to the .devClub website.
4+
5+
Before making changes:
6+
7+
1. Create a new branch from `main`
8+
2. Make your changes
9+
3. Test the site locally
10+
4. Open a Pull Request
11+
12+
---
13+
14+
# Adding New Executives
15+
16+
Executive team members are configured in:
17+
18+
```
19+
src/resources/data/teamConfig.ts
20+
```
21+
22+
Add a new year entry containing all executives for that year.
23+
24+
Example:
25+
26+
```ts
27+
"20xx": [
28+
{
29+
firstName: "Person",
30+
middleName: "Number", // optional
31+
lastName: "One",
32+
role: "Executive role",
33+
image: "/assets/team/20xx/headshot.png",
34+
linkedin: "https://linkedin.com/in/username",
35+
github: "https://github.com/username",
36+
instagram: "", // optional
37+
discord: "", // optional
38+
website: "" // optional
39+
}
40+
]
41+
```
42+
43+
Place the corresponding headshot image in:
44+
45+
```
46+
public/assets/team/20xx/
47+
```
48+
49+
---
50+
51+
# Adding New Events
52+
53+
Events are configured in:
54+
55+
```
56+
src/resources/data/events.ts
57+
```
58+
59+
Add a new entry including:
60+
61+
- Event name
62+
- Description
63+
- Event image/banner
64+
- Optional path/link
65+
- Optional recurring flag
66+
67+
Run the project locally to verify the event renders correctly.
68+
69+
---
70+
71+
# Adding Upcoming Events
72+
73+
Upcoming events are also configured in:
74+
75+
```
76+
src/resources/data/events.ts
77+
```
78+
79+
Fields you may use:
80+
81+
- `upcomingTitle`
82+
- `upcomingDescription`
83+
- `date`
84+
- `location`
85+
- `rsvp`
86+
- `upcomingImage`
87+
88+
If unsure about fields, check:
89+
90+
```
91+
src/resources/data/types.ts
92+
```
93+
94+
---
95+
96+
# Adding a New .devHacks Page
97+
98+
Open:
99+
100+
```
101+
src/resources/data/hackathonInfoConfig.ts
102+
```
103+
104+
Add a new year entry with the relevant hackathon information.
105+
106+
A route will automatically be created:
107+
108+
```
109+
/devhacks/20xx
110+
```
111+
112+
Run the project locally and verify the page works.
113+
114+
---
115+
116+
# Adding Prize Categories for .devHacks
117+
118+
Update `hackathonThemeConfig.ts` with:
119+
120+
- A new year entry
121+
- Prize name
122+
- Description
123+
124+
Confirm the prize appears correctly on a
125+
`devhacks/202x/themes` route.
126+
127+
---
128+
129+
# Adding Sponsors for .devHacks
130+
131+
1. Add sponsor logos to the correct devhacks year folder inside:
132+
133+
```
134+
src/resources/images/devhacks/202x/sponsors
135+
```
136+
137+
2. Import them in:
138+
139+
```
140+
src/resources/data/devHacksArchive/HackathonYearSponsors.tsx
141+
```
142+
143+
Verify the images load and display properly.
144+
145+
---
146+
147+
# Adding Pictures for .devHacks
148+
149+
1. Add images to the correct devhacks year folder inside:
150+
151+
```
152+
src/resources/images/images/devhacks/202x/pictures
153+
```
154+
155+
2. Import them in:
156+
157+
```
158+
src/resources/data/devHacksArchive/HackathonYearPictures.tsx
159+
```
160+
161+
Confirm the gallery displays correctly.
162+
163+
---
164+
165+
# Adding .devHacks Winners
166+
167+
Winners are configured in:
168+
169+
```
170+
src/resources/data/hackathonWinners.ts
171+
```
172+
173+
Add:
174+
175+
- Project name
176+
- Team members
177+
- Prize category
178+
179+
Verify spelling and formatting before committing.
180+
181+
---
182+
183+
# Adding Archive Cards to the Main .devHacks Page
184+
185+
Archive cards display previous hackathons.
186+
187+
Add a card containing:
188+
189+
- Hackathon year
190+
- Title
191+
- Short description
192+
- Image
193+
- Link to the hackathon page
194+
195+
Confirm it appears in the archive section.
196+
197+
---
198+
199+
# Notes for Contributors
200+
201+
Before opening a Pull Request:
202+
203+
- Test changes locally
204+
- Follow existing code style
205+
- Verify images and links load correctly
206+
- Avoid committing unnecessary files
207+
208+
---
209+
210+
Thank you for helping improve the **.devClub website** 🚀

0 commit comments

Comments
 (0)