# Creating a Brigade-Wide Project Index \[Brigade Congress 2019\]

**URL:** <https://discourse.codeforamerica.org/t/creating-a-brigade-wide-project-index-brigade-congress-2019/639>\
**Category:** Projects\
**Tags:** brigadecongress-2019\
**Created:** [October 18, 2019, 7:01pm UTC](https://discourse.codeforamerica.org/t/creating-a-brigade-wide-project-index-brigade-congress-2019/639 "2019-10-18T19:01:22Z")\
**Posts on this page:** 8\
**Page:** 1

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/flex020/uploads/codeforamerica/original/1X/fb33b2244d0a2cc0f325dc325b7cc97f24be6b72.png) [@system](https://discourse.codeforamerica.org/u/system)\
**Post date:** [October 18, 2019, 7:01pm UTC](https://discourse.codeforamerica.org/t/creating-a-brigade-wide-project-index-brigade-congress-2019/639/1 "2019-10-18T19:01:22Z")

</div>

This is a placeholder for notes and discussion about the Brigade Congress 2019 session:

Session: _Creating a Brigade-Wide Project Index_  
Presented by: _Bonnie Wolfe (Hack for LA), Colin King-Bailey (OpenOakland), Chris Alfano (Code for Philly)_

Notes Document:

> **[\[Notes\] Creating a Brigade-Wide Project Index – Brigade Congress 2019](https://docs.google.com/document/d/1RBZe0h127_IL4hVLSPp4sArEZPvbCCZQF91eLhvWf-I/edit#)**
>
> Creating a Brigade-Wide Project Index by Bonnie Wolfe (Hack for LA), Colin King-Bailey (OpenOakland), Chris Alfano (Code for Philly) – Brigade Congress 2019 Session Notes What is the value of the index to you? Who are you? \* 19 attendees Know what...

## Links from session

- [`brigade.cloud`](https://brigade.cloud/): Brigade Project Index homepage
- [`brigade-project-index` GitHub repository](https://github.com/codeforamerica/brigade-project-index)
  - [`index/v1:/`](https://github.com/codeforamerica/brigade-project-index/tree/index/v1): The index in raw data form, projected into a GitHub repo for distribution and historic tracking
  - [`master:docs/`](https://github.com/codeforamerica/brigade-project-index/tree/master/docs): The source for this website
  - [`master:crawler/`](https://github.com/codeforamerica/brigade-project-index/tree/master/crawler): Script that crawls every brigade’s projects list hourly
  - [`master:.github/workflows`](https://github.com/codeforamerica/brigade-project-index/blob/master/.github/workflows/crawler.yml): GitHub Actions Workflow that runs the crawler every hour
  - [Actions log](https://github.com/codeforamerica/brigade-project-index/actions): History of crawler runs

- [Network-wide topic search engine](https://hackforla.github.io/github-api-test/)
- [Network-wide index status board](https://brigade-project-index-test.herokuapp.com/#/topics)
- [`publiccode.yml` standard](https://docs.italia.it/italia/developers-italia/publiccodeyml-en/en/master/)
- [GitHub Community Health Files standards](https://help.github.com/en/articles/creating-a-default-community-health-file-for-your-organization)

## Next Steps

- Give lightning workshop at your brigade on topic tags (message @ExperimentsInHonesty and she will make you a custom slide deck)
- Join project index working group
  - Meets online every other Sunday to work on the tools

- Join us on Slack at [`#brigade-project-index`](https://cfa.slack.com/messages/CLMA6BAVB)

---

<div class="post-metadata">

**Author:** ![tdooner](https://sea2.discourse-cdn.com/flex020/user_avatar/discourse.codeforamerica.org/tdooner/32/3_2.png) [@tdooner](https://discourse.codeforamerica.org/u/tdooner)\
**Post date:** [October 18, 2019, 8:53pm UTC](https://discourse.codeforamerica.org/t/creating-a-brigade-wide-project-index-brigade-congress-2019/639/2 "2019-10-18T20:53:55Z")

</div>

@ExperimentsInHonesty @ckingbailey @chris - Here is the notes thread for your unconference session, please update it with any notes, links, etc. that exist from your session.

---

<div class="post-metadata">

**Author:** ![Dianna](https://sea2.discourse-cdn.com/flex020/user_avatar/discourse.codeforamerica.org/dianna/32/464_2.png) [@Dianna](https://discourse.codeforamerica.org/u/Dianna)\
**Post date:** [October 18, 2019, 8:57pm UTC](https://discourse.codeforamerica.org/t/creating-a-brigade-wide-project-index-brigade-congress-2019/639/3 "2019-10-18T20:57:59Z")

</div>

Here’s the New York Times collaborative “documentation site” which is google docs based. I personally have dug very far into it yet, but people on my team have and will be using this tool to collect and introduce projects. Your github searcher could sit at the top of that site and it can be used to tell the story of the projects as well and easily include or link to outside resources that were used and collect onboarding materials. I think it could be more approachable for less techy folks.

> **[nytimes/library](https://github.com/nytimes/library)**
>
> A collaborative documentation site, powered by Google Docs. - nytimes/library

---

<div class="post-metadata">

**Author:** ![chris](https://sea2.discourse-cdn.com/flex020/user_avatar/discourse.codeforamerica.org/chris/32/10_2.png) [@chris](https://discourse.codeforamerica.org/u/chris)\
**Post date:** [October 21, 2019, 5:57pm UTC](https://discourse.codeforamerica.org/t/creating-a-brigade-wide-project-index-brigade-congress-2019/639/4 "2019-10-21T17:57:39Z")

</div>

Here’s a document I made recently and forgot about that should be helpful for anyone looking to wrap their head around the overall technical architecture I think we’re aiming for right now:

> **[Layers of the Brigade Project Index](https://docs.google.com/document/d/1dt07g7rWiBYCrMdpZ0Ejta2X2NiSfMZyINATwCp5z0U/edit?pli=1)**
>
> Layers of the Brigade Project Index Layer 1) Primary sources The actual work products of project teams: Git repo: code (package.json, docker-compose.yml, composer.json, etc) Git repo: content (README.md, LICENSE.md, CONTRIBUTING.md, docs/,...

---

<div class="post-metadata">

**Author:** ![gregboyer](https://sea2.discourse-cdn.com/flex020/user_avatar/discourse.codeforamerica.org/gregboyer/32/387_2.png) [@gregboyer](https://discourse.codeforamerica.org/u/gregboyer)\
**Post date:** [October 28, 2019, 12:36am UTC](https://discourse.codeforamerica.org/t/creating-a-brigade-wide-project-index-brigade-congress-2019/639/5 "2019-10-28T00:36:47Z")

</div>

Reminders that we have a 6pm (PST) meeting about to start for anyone interested.

For info on how to call in, please check cfa slack #brigade-project-index.

---

<div class="post-metadata">

**Author:** ![gregboyer](https://sea2.discourse-cdn.com/flex020/user_avatar/discourse.codeforamerica.org/gregboyer/32/387_2.png) [@gregboyer](https://discourse.codeforamerica.org/u/gregboyer)\
**Post date:** [October 28, 2019, 1:14am UTC](https://discourse.codeforamerica.org/t/creating-a-brigade-wide-project-index-brigade-congress-2019/639/6 "2019-10-28T01:14:36Z")

</div>

“what value would this be to you?” from Brigade Congress

 ![IMG_2281](https://us1.discourse-cdn.com/flex020/uploads/codeforamerica/original/1X/e5507490b499c234d6212218564e8738f818cfab.jpeg)

---

<div class="post-metadata">

**Author:** ![Bonnie](https://avatars.discourse-cdn.com/v4/letter/b/a698b9/32.png) [@Bonnie](https://discourse.codeforamerica.org/u/Bonnie)\
**Post date:** [July 1, 2023, 3:57am UTC](https://discourse.codeforamerica.org/t/creating-a-brigade-wide-project-index-brigade-congress-2019/639/7 "2023-07-01T03:57:07Z")

</div>

This project will continue…  
The following repositories are going to be moved from

> **[GitHub - codeforamerica/brigade-project-index-statusboard: A "statusboard"...](https://github.com/codeforamerica/brigade-project-index-statusboard)**
>
> A "statusboard" web app that is designed to display ongoing realtime information about each brigade's project-indexing opportunities. - GitHub - codeforamerica/brigade-project-index-s...

> **[GitHub - codeforamerica/brigade-project-index: Brigade Project Index](https://github.com/codeforamerica/brigade-project-index)**
>
> Brigade Project Index. Contribute to codeforamerica/brigade-project-index development by creating an account on GitHub.

to

> **[GitHub - civictechindex/brigade-project-index-statusboard: A "statusboard"...](https://github.com/civictechindex/brigade-project-index-statusboard)**
>
> A "statusboard" web app that is designed to display ongoing realtime information about each brigade's project-indexing opportunities. - GitHub - civictechindex/brigade-project-index-s...

[https://github.com/civictechindex/brigade-project-index](https://github.com/civictechindex/brigade-project-index)

---

<div class="post-metadata">

**Author:** ![Mari](https://sea2.discourse-cdn.com/flex020/user_avatar/discourse.codeforamerica.org/mari/32/992_2.png) [@Mari](https://discourse.codeforamerica.org/u/Mari)\
**Post date:** [July 1, 2023, 7:04am UTC](https://discourse.codeforamerica.org/t/creating-a-brigade-wide-project-index-brigade-congress-2019/639/8 "2023-07-01T07:04:41Z")

</div>