Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add page for project mgmt and calendaring #280

Merged
merged 13 commits into from
Jan 16, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions _quarto.yml
Original file line number Diff line number Diff line change
Expand Up @@ -146,6 +146,8 @@ website:
- section: "Contributing"
href: contributing/index.qmd
contents:
- text: "Calendaring and Project Management"
href: contributing/calendar-project-management.qmd
- text: "Onboarding Mentors"
href: contributing/onboarding.qmd
- text: "Setup"
Expand Down
44 changes: 44 additions & 0 deletions contributing/calendar-project-management.qmd
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
## GitHub for Project Management and Calendaring

People want to be able to see ongoing NASA Openscapes and DAAC events, their status, and where they fit in our calendars. The way we use [GitHub Projects](https://docs.github.com/en/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects) for this purpose will evolve as people see what works for them.
stefaniebutland marked this conversation as resolved.
Show resolved Hide resolved

![MainPlanning GitHub Project - Status Table view](images/github-project-views.png){width="85%"}

stefaniebutland marked this conversation as resolved.
Show resolved Hide resolved
**The [MainPlanning](https://github.com/orgs/NASA-Openscapes/projects/7) Project** pulls from several repositories in the NASA-Openscapes GitHub organization:

- [how_we_work](https://github.com/NASA-Openscapes/how_we_work) - for tracking `earthaccess` and other items not included in specific repos listed next
- [workshop-planning](https://github.com/NASA-Openscapes/workshop-planning) for planning & calendaring workshops
- [earthdata-cloud-cookbook](https://github.com/NASA-Openscapes/earthdata-cloud-cookbook)
- cloud-infrastructure (to be created); currently conversations tracked in [2i2cAccessPolicies](https://github.com/NASA-Openscapes/2i2cAccessPolicies)
- MATLAB
- 2i2c access policy & fledging (TODO: [2i2cAccessPolicies](https://github.com/NASA-Openscapes/2i2cAccessPolicies) is currently a repo - should this move into Cookbook?)
stefaniebutland marked this conversation as resolved.
Show resolved Hide resolved


## How are we using it?

Here we'll use the [workshop-planning](https://github.com/NASA-Openscapes/workshop-planning) repo as an example. The way we use it will evolve to meet people's needs and use cases.

### Issues

Are you leading a workshop or attending a meeting? Open an issue in the workshop-planning repo. The issue title should have the workshop name and date. Add the issue to the MainPlanning project. We can do this either from the issue or from the project.

### Labels

Add one or more labels to the issue, like `workshop`, or the names of the participating DAACs.

::: callout-note
## Labels can be edited

Labels are defined at the repo level. If you want to add a new label, check what already exists in other repos and add a new label by copying label names and color codes. (TODO: customize NASA-Openscapes org default labels - [how to](https://docs.github.com/en/organizations/managing-organization-settings/managing-default-labels-for-repositories-in-your-organization))
:::

### Viewing a Project

We've set up two ways to view the MainPlanning Project: as a Status Table (<https://github.com/orgs/NASA-Openscapes/projects/7/views/1>) or a Roadmap Schedule (<https://github.com/orgs/NASA-Openscapes/projects/7/views/3>).

Notice the URLs above. Each links to a specific view of the same Project. Anyone can add a new view, sort the issues to suit their needs, name it, and save it. It will have its own URL.


### Start and End dates

TODO: how to add and view
Binary file added contributing/images/github-project-views.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.