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

[system]

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

Links from session

• brigade.cloud: Brigade Project Index homepage
• brigade-project-index GitHub repository
  • index/v1:/: The index in raw data form, projected into a GitHub repo for distribution and historic tracking
  • master:docs/: The source for this website
  • master:crawler/: Script that crawls every brigade’s projects list hourly
  • master:.github/workflows: GitHub Actions Workflow that runs the crawler every hour
  • Actions log: History of crawler runs
• Network-wide topic search engine
• Network-wide index status board
• publiccode.yml standard
• GitHub Community Health Files standards

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

[tdooner]

@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.

[Dianna]

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

[chris]

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

[gregboyer]

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.

[gregboyer]

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