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

Software support docs update #35

Merged
merged 10 commits into from
Feb 13, 2024
Merged

Conversation

Kelvinrr
Copy link
Collaborator

@Kelvinrr Kelvinrr commented Feb 9, 2024

Updating the software support docs to add more context and a mention of continuous support.

Licensing

This project is mostly composed of free and unencumbered software released into the public domain, and we are unlikely to accept contributions that are not also released into the public domain. Somewhere near the top of each file should have these words:

This work is free and unencumbered software released into the public domain. In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the software to the public domain.

  • I dedicate any and all copyright interest in this software to the public domain. I make this dedication for the benefit of the public at large and to the detriment of my heirs and successors. I intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.

docs/how-to-guides/software-management/software-support.md Outdated Show resolved Hide resolved
docs/how-to-guides/software-management/software-support.md Outdated Show resolved Hide resolved
docs/how-to-guides/software-management/software-support.md Outdated Show resolved Hide resolved
docs/how-to-guides/software-management/software-support.md Outdated Show resolved Hide resolved
docs/how-to-guides/software-management/software-support.md Outdated Show resolved Hide resolved
docs/how-to-guides/software-management/software-support.md Outdated Show resolved Hide resolved
## Continous Support

An additional 2 weeks per quarter are dedicated for handling small issues. We refer to this as continious support, as it's suppport time between dedicated sprints. This amounts to roughly 6 hours a week to stay on top of GitHub notifications.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 week per what? For someone external I would just say, we allocate X hours or X FTE per quarter that stuff happens in.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also, is this much information (task levels per dev how many hours) really necessary? What is the rationale for giving this much insight? (I ask because external folks may assess the speed with which they get a response with the perception that someone has 6 hours per week without knowing all of the context.)

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 week per what? For someone external I would just say, we allocate X hours or X FTE per quarter that stuff happens in.

I can probably change this to "roughly 6 hours a week between support sprints."

Also, is this much information (task levels per dev how many hours) really necessary?

Writing down the expectations for continuous support was one of the action items that came out of the last retro. Originally, I was going to make it internal, but couldn't see the harm of including it here. I usually big on transparency, but if there is reason it might be a problem in this context I'm open to moving it internal.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

updated this, and moved most of the original text into the internal docs.

docs/how-to-guides/software-management/software-support.md Outdated Show resolved Hide resolved
@Kelvinrr
Copy link
Collaborator Author

Kelvinrr commented Feb 13, 2024

I kinda just want this merged so I just removed all the stuff about continuous support and internal stuff. We will point USGS devs to the internal doc independent of this page so those admonitions were also removed.

@Kelvinrr Kelvinrr merged commit 8aae7cf into DOI-USGS:main Feb 13, 2024
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants