Repository navigation
Expand file tree
/
Copy pathcontribute.html
More file actions
413 lines (396 loc) · 17.3 KB
/
Copy pathcontribute.html
File metadata and controls
413 lines (396 loc) · 17.3 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
---
layout: default
title: "Contribute — OpenSolano"
description: "How to participate in OpenSolano. No tech background required. Start where you are, with what you know."
permalink: /contribute/
---
<main class="isolate pt-28">
<div class="relative isolate -z-10 overflow-hidden bg-gradient-to-b from-indigo-100/20">
</div>
<article class="mx-auto max-w-3xl px-6 lg:px-8 mb-16">
<h1 class="text-3xl font-bold tracking-tight text-gray-900 sm:text-4xl">
How to contribute
</h1>
<p class="mt-4 text-lg leading-8 text-gray-600">
OpenSolano is a community project.
Everything on this site is open source, and contributions come from residents who care about making local government more legible and participatory.
</p>
<p class="mt-2 text-lg leading-8 text-gray-600">
You don't need a tech background.
Start where you are, with what you know.
</p>
<!-- Contribution types -->
<div class="mt-12 space-y-12">
<!-- 1. Share what you know -->
<section>
<div class="flex items-start gap-4">
<div
class="flex h-10 w-10 shrink-0 items-center justify-center rounded-lg bg-indigo-600 text-white font-bold text-sm">
1
</div>
<div>
<h2 class="text-xl font-bold text-gray-900">
Share what you know
</h2>
<p class="mt-2 text-gray-600">
The most valuable contributions are often local knowledge that doesn't exist in any database.
</p>
</div>
</div>
<div class="mt-4 ml-14 space-y-3">
<div class="bg-white border border-gray-200 rounded-lg p-4">
<h3 class="text-sm font-semibold text-gray-900">
Submit feedback on a parcel
</h3>
<p class="mt-1 text-sm text-gray-600">
Visit <a
href="/parcels/"
class="text-indigo-600 hover:text-indigo-500 underline">/parcels</a>, pick a site, and tell us what you'd like to see there.
The form takes two minutes.
</p>
</div>
<div class="bg-white border border-gray-200 rounded-lg p-4">
<h3 class="text-sm font-semibold text-gray-900">
Attend a meetup
</h3>
<p class="mt-1 text-sm text-gray-600">
We meet regularly in Vacaville.
Bring your questions, interests, or just come listen.
See <a
href="/meetup"
class="text-indigo-600 hover:text-indigo-500 underline">/meetup</a> for dates.
</p>
</div>
<div class="bg-white border border-gray-200 rounded-lg p-4">
<h3 class="text-sm font-semibold text-gray-900">
Report something you noticed
</h3>
<p class="mt-1 text-sm text-gray-600">
A data error, a missing park, a parcel address that's wrong, a link that's broken.
Email <a
href="mailto:ryan@civic.studio"
class="text-indigo-600 hover:text-indigo-500 underline">ryan@civic.studio</a> or open a GitHub issue.
</p>
</div>
</div>
</section>
<!-- 2. Contribute data -->
<section>
<div class="flex items-start gap-4">
<div
class="flex h-10 w-10 shrink-0 items-center justify-center rounded-lg bg-indigo-600 text-white font-bold text-sm">
2
</div>
<div>
<h2 class="text-xl font-bold text-gray-900">
Contribute data and corrections
</h2>
<p class="mt-2 text-gray-600">
The site runs on data that residents help verify and improve.
If you know something is wrong or missing, you can fix it.
</p>
</div>
</div>
<div class="mt-4 ml-14">
<div class="bg-white border border-gray-200 rounded-lg p-4">
<h3 class="text-sm font-semibold text-gray-900">
What we need
</h3>
<ul class="mt-2 space-y-1.5 text-sm text-gray-600">
<li class="flex items-start gap-2">
<span class="text-indigo-400 mt-1 shrink-0">•</span>
<span>
<strong class="text-gray-900">Verified parcel data</strong> — real addresses, APNs, and zoning for vacant sites
</span>
</li>
<li class="flex items-start gap-2">
<span class="text-indigo-400 mt-1 shrink-0">•</span>
<span>
<strong class="text-gray-900">Street-level photos</strong> — of parks, parcels, and community facilities
</span>
</li>
<li class="flex items-start gap-2">
<span class="text-indigo-400 mt-1 shrink-0">•</span>
<span>
<strong class="text-gray-900">Meeting notes</strong> — summaries from city council, planning commission, or parks commission meetings you attend
</span>
</li>
<li class="flex items-start gap-2">
<span class="text-indigo-400 mt-1 shrink-0">•</span>
<span>
<strong class="text-gray-900">Budget and financial data</strong> — links to primary sources, corrections to existing data
</span>
</li>
</ul>
</div>
</div>
</section>
<!-- 3. Use GitHub -->
<section>
<div class="flex items-start gap-4">
<div
class="flex h-10 w-10 shrink-0 items-center justify-center rounded-lg bg-indigo-600 text-white font-bold text-sm">
3
</div>
<div>
<h2 class="text-xl font-bold text-gray-900">
Use GitHub to contribute directly
</h2>
<p class="mt-2 text-gray-600">
OpenSolano's code and data live on GitHub.
If you're comfortable with GitHub, you can propose changes directly.
If you're not, that's okay — this section will get you started.
</p>
</div>
</div>
<div class="mt-4 ml-14 space-y-4">
<!-- What is GitHub -->
<div class="bg-gray-50 border border-gray-200 rounded-lg p-5">
<h3 class="text-sm font-semibold text-gray-900">
What is GitHub?
</h3>
<p class="mt-2 text-sm text-gray-600">
GitHub is where this website's files live.
Think of it like a shared folder that tracks every change anyone makes, who made it, and why.
It's how open-source projects coordinate work among many contributors without stepping on each other.
</p>
<p class="mt-2 text-sm text-gray-600">
You don't need to install anything to get started.
Everything below can be done from a web browser.
</p>
</div>
<!-- Step by step -->
<div class="bg-white border border-gray-200 rounded-lg p-5">
<h3 class="text-sm font-semibold text-gray-900 mb-3">
Getting started (10 minutes)
</h3>
<ol class="space-y-3 text-sm text-gray-600">
<li class="flex items-start gap-3">
<span
class="flex h-6 w-6 shrink-0 items-center justify-center rounded-full bg-indigo-100 text-indigo-700 text-xs font-semibold">
1
</span>
<div>
<strong class="text-gray-900">Create a free GitHub account</strong>
at <a
href="https://github.com/signup"
target="_blank"
rel="noopener"
class="text-indigo-600 hover:text-indigo-500 underline">github.com/signup</a>.
Use whatever email you're comfortable with.
</div>
</li>
<li class="flex items-start gap-3">
<span
class="flex h-6 w-6 shrink-0 items-center justify-center rounded-full bg-indigo-100 text-indigo-700 text-xs font-semibold">
2
</span>
<div>
<strong class="text-gray-900">Visit the OpenSolano repository.</strong>
This is where the website's files live.
Browse around — the <code class="text-xs bg-gray-100 rounded px-1 py-0.5">_data/</code> folder has data files, and <code class="text-xs bg-gray-100 rounded px-1 py-0.5">collections/</code> has the content.
</div>
</li>
<li class="flex items-start gap-3">
<span
class="flex h-6 w-6 shrink-0 items-center justify-center rounded-full bg-indigo-100 text-indigo-700 text-xs font-semibold">
3
</span>
<div>
<strong class="text-gray-900">Open an Issue</strong>
to report a problem, suggest an improvement, or ask a question.
Click the "Issues" tab, then "New issue."
Describe what you noticed.
That's it — someone will respond.
</div>
</li>
<li class="flex items-start gap-3">
<span
class="flex h-6 w-6 shrink-0 items-center justify-center rounded-full bg-indigo-100 text-indigo-700 text-xs font-semibold">
4
</span>
<div>
<strong class="text-gray-900">Edit a file directly</strong>
(when you're ready).
Navigate to any file and click the pencil icon to edit it in your browser.
GitHub will walk you through creating a "pull request" — a proposed change that gets reviewed before it goes live.
</div>
</li>
</ol>
</div>
<!-- What to expect -->
<div class="bg-white border border-gray-200 rounded-lg p-5">
<h3 class="text-sm font-semibold text-gray-900 mb-2">
What to expect
</h3>
<ul class="space-y-2 text-sm text-gray-600">
<li class="flex items-start gap-2">
<svg
class="h-5 w-5 text-green-500 shrink-0 mt-0.5"
fill="none"
viewBox="0 0 24 24"
stroke-width="1.5"
stroke="currentColor">
<path
stroke-linecap="round"
stroke-linejoin="round"
d="M9 12.75L11.25 15 15 9.75M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
</svg>
<span>
<strong class="text-gray-900">Issues get a response within a week.</strong>
Usually faster.
If something is urgent, email directly.
</span>
</li>
<li class="flex items-start gap-2">
<svg
class="h-5 w-5 text-green-500 shrink-0 mt-0.5"
fill="none"
viewBox="0 0 24 24"
stroke-width="1.5"
stroke="currentColor">
<path
stroke-linecap="round"
stroke-linejoin="round"
d="M9 12.75L11.25 15 15 9.75M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
</svg>
<span>
<strong class="text-gray-900">Pull requests get reviewed and merged or discussed.</strong>
Small fixes (typos, data corrections) often merge the same day.
Larger changes get feedback.
</span>
</li>
<li class="flex items-start gap-2">
<svg
class="h-5 w-5 text-green-500 shrink-0 mt-0.5"
fill="none"
viewBox="0 0 24 24"
stroke-width="1.5"
stroke="currentColor">
<path
stroke-linecap="round"
stroke-linejoin="round"
d="M9 12.75L11.25 15 15 9.75M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
</svg>
<span>
<strong class="text-gray-900">No contribution is too small.</strong>
Fixing a typo, adding a missing phone number, or noting that a park's hours changed — it all helps.
</span>
</li>
<li class="flex items-start gap-2">
<svg
class="h-5 w-5 text-green-500 shrink-0 mt-0.5"
fill="none"
viewBox="0 0 24 24"
stroke-width="1.5"
stroke="currentColor">
<path
stroke-linecap="round"
stroke-linejoin="round"
d="M9 12.75L11.25 15 15 9.75M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
</svg>
<span>
<strong class="text-gray-900">Your contributions are public and credited.</strong>
GitHub tracks who contributed what.
This is open-source civic work — your name is on it.
</span>
</li>
</ul>
</div>
</div>
</section>
<!-- 4. For developers -->
<section>
<div class="flex items-start gap-4">
<div
class="flex h-10 w-10 shrink-0 items-center justify-center rounded-lg bg-indigo-600 text-white font-bold text-sm">
4
</div>
<div>
<h2 class="text-xl font-bold text-gray-900">
For developers
</h2>
<p class="mt-2 text-gray-600">
If you write code, the site is Jekyll + Tailwind CSS, deployed to AWS via GitHub Actions.
</p>
</div>
</div>
<div class="mt-4 ml-14">
<div class="bg-gray-900 rounded-lg p-5 text-sm">
<pre class="text-gray-100 overflow-x-auto"><code><span class="text-gray-500"># Clone the repo</span>
git clone https://github.com/opensolano/opensolano.github.io.git
cd opensolano.github.io
<span class="text-gray-500"># Install dependencies</span>
bundle install
npm install
<span class="text-gray-500"># Run the dev server</span>
bundle exec jekyll serve</code></pre>
</div>
<p class="mt-3 text-sm text-gray-600">
Data lives in <code class="text-xs bg-gray-100 rounded px-1 py-0.5">_data/</code>.
Content lives in <code class="text-xs bg-gray-100 rounded px-1 py-0.5">collections/</code>.
Layouts are in <code class="text-xs bg-gray-100 rounded px-1 py-0.5">_layouts/</code>.
Check the README and CLAUDE.md for architecture details.
</p>
</div>
</section>
</div>
<!-- What participation means here -->
<div class="mt-16 pt-8 border-t border-gray-200">
<h2 class="text-xl font-bold text-gray-900 mb-4">
What participation means here
</h2>
<div class="prose prose-lg prose-indigo max-w-none">
<p>
OpenSolano is practicing a form of participation.
Not attending a meeting and hoping someone listens.
Not signing a petition.
Participation as a sustained practice — showing up with local knowledge, improving shared tools, and building a civic record that outlasts any single meeting or election cycle.
</p>
<p>
GitHub is the platform because it treats contributions as first-class objects.
Every correction is tracked.
Every improvement is attributed.
Every proposed change can be discussed before it goes live.
That's what civic infrastructure should look like.
</p>
<p>
The goal is not to turn residents into software developers.
The goal is to give people a way to contribute what they know to a shared resource that gets better over time — and to see their contribution land.
</p>
</div>
</div>
<!-- Contact -->
<div class="mt-12 rounded-2xl bg-gray-50 px-6 py-8">
<div class="mx-auto max-w-2xl text-center">
<h3 class="text-xl font-bold tracking-tight text-gray-900">
Not sure where to start?
</h3>
<p class="mx-auto mt-4 max-w-xl text-sm leading-6 text-gray-600">
Come to a meetup and we'll find something that matches your interests and skills.
Or just email — every conversation helps.
</p>
<div class="mt-6 flex items-center justify-center gap-x-4">
<a
href="/meetup"
class="rounded-md bg-indigo-600 px-3.5 py-2.5 text-sm font-semibold text-white shadow-sm hover:bg-indigo-500 focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-indigo-600">
Meetup schedule
</a>
<a
href="mailto:ryan@civic.studio"
class="text-sm font-semibold leading-6 text-gray-900">
Email us <span aria-hidden="true">→</span>
</a>
</div>
</div>
</div>
</article>
</main>
<style>
.prose p {
@apply text-gray-700 leading-7 mb-4;
}
.prose a {
@apply text-indigo-600 hover:text-indigo-500 underline;
}
</style>