General Process/Tasks Outline

• Rename to Collaborative-distributed-science-guide
  • ALL links must point to new repo name location (e.g., questions comments and concerns at bottom of page, etc.)
    • These should be identified and identifiable for reuse—can this be encoded with a config? Otherwise find and replace through codebase.
• Add comments at personalization points (eg., logos, title, etc)
  • Specific files to update and guidance should be provided in the README as well
• Set shared logo
• Make shared code of conduct: combine the Code of Conduct (i.e., replace each instance of "Imageomics" with "Imageomics and ABC" or "Imageomics or ABC" as appropriate, since this is a shared space and the Code of Conduct for both are the same)
• Update homepage:
  • To have logo location with single shared logo? (<Organization> Branding (Logos) or Imageomics-ABC Branding (Logos), could include one of each?)
  • Explain background/history (as it does now up to generalization as base repo/template).
  • Collaborative Infrastructure We Use section—have both Institute and Center Code repositories (where Institute and Center get URLs)?
• Update citation with new name, v2.0.0, include Net, Graham, and Iuliia.
• Generate DOI on Zenodo for the Collaborative-distributed-science-guide through the GH integration (change name prior to release).
• Recommend adding the template/base repo as reference in CITATION.cff for forks? —We will do this for the Imageomics-guide and the ABC-guide
  • Shared Imageomics & ABC grant acknowledgment will be added to the repo README, as each site will just have its own acknowledgement in the footer.
  • Do we want to indicate our shared source repo on the websites themselves in some way (i.e., in the footer)?
• Add Imageomics-guide tag in repo before generalization point
• To-Do before generalization point:
  • Add in FAIR Guide section with checklists (PR Add FAIR Guide with Checklists #37)
  • Two bug fixes (Update .zendo.json instructions/references #14 & gh-pages branch protection rules in conflict with PR merge rules #21)

Proposed Method

The Imageomics-Guide needs to stay up during this process, so I propose the creation of a dev branch to work on the generalization. We will treat it as we do main, setting up branch protections and following the PR process to make the changes outlined above.

Specifically, I propose creating this new branch after merging PR #37, at which point I will add a tag to the commit. Once all changes are completed, rename and release has occurred, we will then create Imageomics-guide and ABC-guide forks on the respective GH Orgs to get the specific guides up and running.

Changes as follows:

• Replace all instances of "Imageomics-guide" with "Collaborative-distributed-science-guide" (equiv. "Imageomics Guide" --> "Collaborative Distributed Science Guide").
  • URLs and descriptions
  • Most URLs are relative links, but we have "Questions, Comments, Concerns"
• Set shared logo in mkdocs.yaml
• README: keep existing info with name update and add the following
  • Combined grant acknowledgement
  • Indicate which files should be updated/personalized (include comments in those files where appropriate, e.g., mkdocs.yaml title, logo, etc.)
  • Add any other information about suggested citation or acknowledgement---does this go into website somehow? The Imageomics and ABC guides will be a model, but good to be explicit in the README about what to do with this.
• Website homepage (docs/index.md):
  • Include links to both Imageomics and ABC collaborative infrastructure: "Imageomics and ABC Code Repositories" and "Imageomics and ABC Organization Pages"
  • Is there a desire to edit or remove the collaborative infrastructure diagram?
  • For the logos, do we want to have a single shared logo? (<Organization> Branding (Logos) or Imageomics-ABC Branding (Logos), could include one of each?)
• Why use the Institute GH & HF pages can both be changed to "why use our organization GH/HF" (alternatively, "the organization"), italics used to highlight difference only.
• Code of Conduct will be combined (i.e., replace each instance of "Imageomics" with "Imageomics and ABC" or "Imageomics or ABC" as appropriate).
• Update CITATION.cff to include Net, Iuliia, and Graham, will be v2.0.0 v1.0.0 on release---Imageomics Guide will go to v2.0.0.
• Add Digital Product Policies + landing page (explain as Imageomics versions, useful as template).
• Push dev branch to new Imageomics/Collaborative-distributed-science-guide repo.
• Revert all changes back to Imageomics-specific (still on dev), include also:
  • Removing ABC templates
  • Set acknowledgement back to just Imageomics grant in footer.
  • Update CONTRIBUTING.md to be just for Imageomics Guide and possibly include pointer to template for general updates.

Pages that have Imageomics-specific aspects to leave as they are:

• Digital Products Release Licensing Policy
• templates pages--have both Imageomics & ABC
• Infrastructure
• Glossary