Skip to content

Conversation

egrace479
Copy link
Member

Closes #44.

  • Adds comments in mkdocs.yaml about how to personalize the site and include proper attribution.
  • Updates description in README to how to interact with and use the template repo, includes joint acknowledgment statement.
  • Adds full team to CITATION.cff, sets version and description for Collaborative Distributed Science Guide (distinct from Imageomics-Guide, see explanation in On dev: README and mkdocs.yaml edits #44).

This is a joint-review request since everyone's name is being added here and it's about presentation of the guide.

@egrace479 egrace479 added this to the Generalize Guide milestone Jun 11, 2025
@egrace479 egrace479 added design UX or presentation needs attention documentation Improvements or additions to documentation structure Refactoring or architecture, general code organization labels Jun 11, 2025
Copy link
Member

@hlapp hlapp left a comment

Choose a reason for hiding this comment

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

Looks great 👍

@egrace479 egrace479 changed the base branch from main to dev June 18, 2025 14:18
egrace479 and others added 8 commits June 18, 2025 11:10
- Change "Checkout" to "Check out"
- Remove hyphen from "broadly-applicable"
- Change "Acknowledgement" to "Acknowledgments"
- Remove duplicate edit_uri field
- Standardize edit_uri to use edit/main/docs/ pattern
- Add individual comments to each personalizable field
- Improve comment consistency and clarity
Copy link
Collaborator

@gwtaylor gwtaylor left a comment

Choose a reason for hiding this comment

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

Review Summary

I've reviewed this PR and made the following changes:

README.md

  • Replaced "web site" with "website" to modernize terminology
  • Improved tone and clarity by refining language and fixing typos
  • Enhanced consistency in explanations and formatting

mkdocs.yaml

  • Removed duplicate edit_uri entry and standardized the path
  • Improved comments for clarity and consistency
  • Ensured all personalizable fields have specific comments

Approved for merge.

@egrace479 egrace479 merged commit b4e30e2 into dev Jun 30, 2025
@egrace479 egrace479 deleted the dev-44 branch June 30, 2025 22:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
design UX or presentation needs attention documentation Improvements or additions to documentation structure Refactoring or architecture, general code organization
Projects
None yet
Development

Successfully merging this pull request may close these issues.

On dev: README and mkdocs.yaml edits
3 participants