Skip to content

Conversation

@rxu17
Copy link
Contributor

@rxu17 rxu17 commented Nov 5, 2025

Problem:

Some parts of our README and CONTRIBUTING docs are outdated/ could be reshuffled.

Solution:

Main feature to the docs is adding developing with docker sections as that is our most reproducible method for testing and developing with the genie pipeline.

I also removed devcontainers because that's not currently very feasible with the R side of our environment and docker. See https://sagebionetworks.jira.com/browse/GEN-2380?focusedCommentId=272977 for more info on this.

Testing:

Run through commands

@rxu17 rxu17 added the run_integration_tests Runs integrations tests in the CI/CD label Nov 6, 2025
@rxu17 rxu17 marked this pull request as ready for review November 7, 2025 00:13
@rxu17 rxu17 requested a review from a team as a code owner November 7, 2025 00:13
@rxu17 rxu17 removed the run_integration_tests Runs integrations tests in the CI/CD label Nov 7, 2025
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I realize this CONTRIBUTING doc has a mix of development guidelines for external and specific to sage developers, e.g: only sage bionetworks developers can utilize the run_integration_tests functionality. I might just migrate all of the sage specific to README under Sage Bionetworks only and keep this section just for the forking and adding changes for external developers.
They can still pull the public images and build images via Dockerfile to do testing. But they won't be able to run any of our pipeline steps etc etc

Copy link
Member

Choose a reason for hiding this comment

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

May be helpful to get xindis feedback on this

Copy link
Contributor Author

@rxu17 rxu17 Nov 7, 2025

Choose a reason for hiding this comment

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

Sounds good, I added that as AC for the relevant onboarding tickets - to review and approve the documentation

@sonarqubecloud
Copy link

sonarqubecloud bot commented Nov 7, 2025

Copy link
Member

@thomasyu888 thomasyu888 left a comment

Choose a reason for hiding this comment

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

🔥 LGTM!

@rxu17 rxu17 requested a review from xindiguo November 11, 2025 21:43
@rxu17 rxu17 merged commit 91ce5d9 into develop Nov 13, 2025
12 checks passed
@rxu17 rxu17 deleted the gen-2380-update-docs branch November 13, 2025 21:36
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