Skip to content

Commit

Permalink
Add 2023 Sprint Folder (Philadelphia)
Browse files Browse the repository at this point in the history
  • Loading branch information
PowerChell authored Aug 16, 2023
1 parent cd6cc88 commit c9f0e61
Show file tree
Hide file tree
Showing 6 changed files with 287 additions and 0 deletions.
76 changes: 76 additions & 0 deletions 09262023-philadelphia-pa/agenda.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,76 @@
# Overview

The sprint runs for 3 days, September 26, 27, and 28th. The main activities will run 9-5 Eastern time (check the
[start time on worldclock](https://www.timeanddate.com/worldclock/meetingdetails.html?year=2019&month=11&day=5&hour=14&min=0&sec=0&p1=263&p2=136&p3=16&p4=224&p5=145) to confirm time difference). Each day we will have a kickoff in the morning
at 9 am as one big group, including the remote attendees. Most work through the sprint will be done in smaller groups, who will work
for a time and then come together to report out and get feedback from other groups. Virtual attendees will have the option to work with other remote attendees, but the majority of the breakout groups will not be hybrid. Breakout groups and objectives will be determined each morning. At the end of each day, a full group, hybrid session will be held to report progress made during the day.

### Remote Participation

We aspire to make the sprint as accessible as possible to remote attendees. At the onsite facility, there are two rooms that should
have good built-in video conferencing facilities. We will post the information here when we get it. In the agenda below
any session in **bold** will be in the 'main' room and we be sure the video works.

All Zoom links to join main room events will be placed here.

## Sprint Objectives

The hourly agenda is still under construction. For now, here are some priority focus areas for this sprint:

### Technical Improvements

This section includes STAC specification improvements as well as STAC tooling ecosystem.

- Close out all open issues in [stac-spec](https://github.com/radiantearth/stac-spec/issues) in order to get to 1.1.0.

- STAC Spec Extensions: reach a consensus on [RFC: A common construct to replace raster:bands and eo:bands](https://github.com/radiantearth/stac-spec/discussions/1213) and carry out changes needed based on decision

- STAC Spec Extensions: build new extensions requested in the [new extensions](https://github.com/radiantearth/stac-spec/labels/new%20extension) tags

- API Extensions
- STAC ecosystem improvment to aid STAC: javascript tasks, stac-utils

### STAC Education

- Clean up best practices documents (FAQ page, organization of resources)
- Tutorial creation for STA users, developers, and data providers
- [Potential] tutorial translations

## Day 1

|**Time**|**Title**|**Description**|
|--------|------------|-------------------------------|
|8:30 - 9 | Arrival | In-person arrivals/breakfast @ 990 Spring Garden St #5, Philadelphia, PA. |
|9 - 9:20 | **Welcome** | Overview of event, logistics, etc |
|9:20 - 10:45 | **Introductions** | Brief introductions from everyone, so we all know who else is there and where they're coming from|
|10:45 | Break| |
|11:00 - 12:00 | Group work kickoffs | Break up into small groups to advance topics |
|12:00 | Lunch ||
|1:00 - 4:30 | Continued group work | |
|4:30 - 5 | **Full group check-in** |
|6:00 | Happy Hour @ TBD | Informal discussion, drinks, food | |

## Day 2

|**Time**|**Title**|**Description**|
|--------|------------|-------------------------------|
|8:30 - 9:00 | Arrival | In-person arrivals/breakfast @ 990 Spring Garden St #5, Philadelphia, PA. |
|9:00 - 9:45 | **Open Lightning Talks** | Talks given by [Cloud-Native Geospatial Founding, Convening, Platinum, and Gold Sponsors](https://cloudnativegeo.org/sponsor-stac-sprint-8.pdf)|
|9:45 - 10:00 | **Small group kick-off** | Set stage and goals for small group work. |
|10:00 - 12:00 | Small group work | Continue in groups from the previous day.|
|12:00 | Lunch | |
|1:00 - 4:30 | Continued group work | |
|4:30 - 5 | **Full group check-in** | |
|7:00 | Social Meetup @ TBD | |

## Day 3

|**Time**|**Title**|**Description**|
|--------|------------|-------------------------------|
|8:30 - 9:00 | Arrival | In-person arrivals/breakfast @ 990 Spring Garden St #5, Philadelphia, PA. |
|9:00 - 9:45 | **Open Lightning Talks** | |
|9:45 - 10:00 | **Small group kick-off** | Set stage and goals for small group work. |
|10:00 - 12:00 | Small group work | Continue in groups from the previous day.|
|12:00 | Lunch ||
|1:00 - 3:00 | Continued group work | |
|3:00 - 5:00 | **Demos and wrap-up** | Show off what you've done to the group! Everyone is encouraged to share. And commit to the next steps and actions to keep moving forward|
36 changes: 36 additions & 0 deletions 09262023-philadelphia-pa/prep-work/implementation-topics.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
# Overview

...

## STAC Ecosystem

*Add your project or project idea here if you'd like people to help out during the sprint*

* pystac - https://pystac.readthedocs.io
* @gadomski to add more here.
* Add yours

## Testing and Validation

* STAC Validator / STAC Lint
* [https://github.com/s22s/stac-api-validator](https://github.com/s22s/stac-api-validator)
* Discussion needed: [Validators report STAC as valid although it is not truly valid](https://github.com/radiantearth/stac-spec/discussions/1242)

## STAC Implementation

Create or improve a STAC Catalog.

Get more data that is publicly available as a STAC catalog, or enhance an existing one. Enhancements include getting
a STAC Browser, custom-styling a STAC Browser, indexing in a STAC API, and getting it working with clients like QGIS,
[sat-api-browser](https://github.com/sat-utils/sat-api-browser), sat-search, etc.

### Build a New STAC Catalog

* *Add dataset here*


### Enhance an Existing STAC Catalog

* *Add dataset here*


74 changes: 74 additions & 0 deletions 09262023-philadelphia-pa/prep-work/outreach-topics.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
# Overview

One of the areas engineers most often underinvest in is communicating with the world about their work. It is a clear goal of
STAC to communicate and educate well. For this set of topics we also appreciate any brainstorming
and creative ideas on how we can get the word out to diverse audiences more, so feel free to propose more.

## Tutorials/Guides

It is crutial for the expanded adoption of STAC to improve the education ecosystem.

The current STAC official tutorials can be found at [stacspec.org/en/tutorials](https://stacspec.org/en/tutorials/).

More resources can be found at [stacindex.org](https://stacindex.org/).

### STAC Users

**Ideas for tutorials:**

- Browsing STAC Catalogs
- ...

### STAC Developers

**Ideas for tutorials:**

- Using datasets that have STAC Catlaogs to search and perform analysis using stac ecosystem tooling (stac-utils)
- ...

### Data Providers

**Ideas for tutorials:**

- Building STAC Catalogs
- ...

## Best Practices Document Improvements

The best practice documents:
- stac-spec [best-practices.md](https://github.com/radiantearth/stac-spec/blob/master/best-practices.md)
- No best practices document for STAC API (yet) -- should we be creating one?

## STAC Website (stacspec.org) Improvements
The STAC website is a github repo at https://github.com/radiantearth/stac-site. Tackling any of the
[issues raised](https://github.com/radiantearth/stac-site/issues) would be a great help. There are also a number of other
things that are deserving of tickets that haven't been written up yet, but would be awesome to do:

* Add more tools, see [#23](https://github.com/radiantearth/stac-site/issues/23) - but ideally we should talk to everyone
at the sprint to make sure we're not missing any tools there.
* Better 'stac in action' section. There are more repositories that are up to speed that would be good to include. This should
also include hosted API instances that people are relying upon (though I think we don't want to have too many that just have
landsat in them).
* [sat-api-browser](https://github.com/sat-utils/sat-api-browser) improvements.
* Mirror the STAC Best Practices document on the site
* Mirror the STAC Specification on the site
* Survey all the previous talks / podcasts that have been given on STAC and put links to them on the website. For example
https://www.youtube.com/watch?v=emXgkNutUTo, and then the ARD conference has also had STAC talks each year, and recorded them.
https://www.youtube.com/watch?v=V5pzZegqndQ and https://www.youtube.com/watch?v=byO0ABXFI4I

### Improved Frequently Ased Questions Page

During the past two STAC working sessions, the attendees have been building an improved list of STAC FAQs. The current STAC FAQ page is neither up to date nor all encompassing to represent beginer's STAC questions. This page is often where people first go, so we want to make sure the document is top-notch.

You can find this document [here](https://docs.google.com/document/d/1gM_189NDaDAg7xvNb4R_OhZVcRdquACoHgcaYuuF4hc/edit).

Please feel free to add to responses and add additional questions.

## Presentations

Creating the equivalent of a 'corporate deck' could be a big win - a set of great looking slides that tell the main story.
This could be customized as needed by the presenter, but it'd be great to give people a great starting point. This is needed
for both STAC and OGC API (features and in general).

It'd also be great to brainstorm on different audiences we'd like to present to, and try to come up with a calendar of events
to hit, and a distributed set of speakers who can attend and talk. This should include podcasts and webinars.
58 changes: 58 additions & 0 deletions 09262023-philadelphia-pa/prep-work/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
# About

This directory is a workspace to collaborate and prepare for the STAC sprint. Everyone is welcome
to edit files and make new workspaces - just make a PR and we will get your information into main. Work will also take place
in other repositories that are specific to the STAC specifications or ecosystem; this space just serves as a collaboration space
with a low barrier to entry.

# Meetings to Attend

There are a handful of STAC meetings occurring in the time leading up to the STAC. We encourage STAC sprint attendees to make as many of the upcoming meetings as possible to get everyone as up-to-speed as possible before the sprint.

#### STAC Community Meeting

General meeting about all things stac-spec and stac-api-spec. The meeting consists of (1) intros and updates from each meeting participant and (2) agenda items (created by anyone that attends the meeting).

**Meeting time:** Every other Monday from 11 am - 12 pm EST (1-hour long meeting)

- Monday, August 14th @ 11 am EST

- Monday, August 28th @ 11 am EST

- Monday, September 11th @ 11 am EST

#### STAC Working Session

A two-hour meeting that allows us to dive into a specific task and get some work done while all online. The agenda is preset by the STAC PSC and there are no intros/updates/check-ins.

**Meeting time:** 1st Tuesday of the month from 11 am - 1 pm EST (2-hour long meeting)

- Tuesday, September 5th @ 11 am EST

#### STAC Ecosystem (stac-utils) Meeting

These meetings are relatively new but have proven helpful to the community. The format of this meeting is similar to that of the STAC Community meeting, but instead of discussing the specifications themselves (stac-spec and stac-api-spec), this meeting discusses work being done/needed for the tools built to help interact with STAC.

**Meeting time:** occasional Mondays from 11 am - 12 pm EST (1-hour long meeting)

- Monday, September 18th @ 11 am EST

# Topics

There are three main categories of topics, and each has its own page or directory to go deeper on. These should serve
to get people working on the topic on the same page before the sprint. Each should have a number of links to give a newer
user the appropriate background and should attempt to frame the major points of the decision. These will likely be various
degrees of WIP (work in progress), as everyone is too busy ahead of the sprint, but something started is better than nothing.

* **[Specification Improvements](specification-topics.md)** - Both [stac-spec](https://github.com/radiantearth/stac-spec) and [stac-api-spec](https://github.com/radiantearth/stac-api-spec) have reached version 1.0.0, yet there are many aspects of each specification to address. Specific topics of work can be found in [specification-topics.md](specification-topics.md).

* **[Ecosystem Development/Implementation](implementation-topics.md)** - The goal of these sprints is to build - software, hosted datasets, testing
tools, etc - with the specification being a side-effect of people working together. So if people are not sure where to
contribute then jumping on this area is one of the best. The [implementation page](implementation-topics.md) details the various
projects people are working on, as well as ideas for new datasets/software, and you can also offer up your skills there.
Testing and validation are also a part of this.

* **[Outreach & Education](outreach-and-education-topics.md)** - The third major topic is outreach, broadly defined. How do we get more people aware
of STAC? How do we help those who have just learned about STAC dive into using the specification and tooling around it? Past sprints have done
things like create the http://stacspec.org website. There are LOTS
more improvements possible on stacspec.org. Developing tutorials for individuals with a wide range of familiarity with STAC is needed.
29 changes: 29 additions & 0 deletions 09262023-philadelphia-pa/prep-work/specification-topics.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# Overview

Specification specific discussions to be had and work to be done.

## STAC Specification

**GitHub Page:** [https://github.com/radiantearth/stac-spec](https://github.com/radiantearth/stac-spec)

* [RFC: A common construct to replace raster:bands and eo:bands](https://github.com/radiantearth/stac-spec/discussions/1213)
* Build New Extensions
* Proposed new extensions found [here](https://github.com/radiantearth/stac-spec/issues?q=is%3Aopen+is%3Aissue+label%3A%22new+extension%22)
* @m-mohr to add more details here.
* ...

## STAC API

**GitHub Page:** [https://github.com/radiantearth/stac-api-spec](https://github.com/radiantearth/stac-api-spec)

* @philvarner to add more details here.
* ...
* ...

## STAC Extensions

**GitHub Page:** [github.com/stac-extensions](https://github.com/stac-extensions)

* Support for IAU Codes
* Discussion found at: [PR #12](https://github.com/stac-extensions/projection/pull/12)
* ...
14 changes: 14 additions & 0 deletions 09262023-philadelphia-pa/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
## Overview

**What:** The first in-person STAC Sprint since 2019.

**When:** September 26-28, 2023.
* Check the [agenda](agenda.md) for the main schedule.

**Where:** 990 Spring Garden St 5th Floor, Philadelphia, PA 19123.

* How to get to the office and nearby lodging: [azavea.com/directions](https://www.azavea.com/directions).


-----
This folder will evolve to hold various workspaces. For now, we are focusing on building out the [prep-work](./prep-work/) folder to help everyone come as prepared as possible.

0 comments on commit c9f0e61

Please sign in to comment.