diff --git a/docs/collaboration/reports/google_summer/2018-gsoc.md b/docs/collaboration/reports/google_summer/2018-gsoc.md index ac578c99..0524098f 100644 --- a/docs/collaboration/reports/google_summer/2018-gsoc.md +++ b/docs/collaboration/reports/google_summer/2018-gsoc.md @@ -88,21 +88,21 @@ and many more. :o: **Problem** Engage more users :heavy_check_mark: **Solution** In person, our team continued to spread the word -about the project during any relevant events. Online, we created an -[animated video](https://camo.githubusercontent.com/aada478abaddf957a3622589a5c370f11bf67642/687474703a2f2f696d672e796f75747562652e636f6d2f76692f425964686a5675427347302f302e6a7067) -to summarize the general idea and make the first step that much easier. We -developed -[extensive contribution guidelines](https://github.com/bids-standard/bids-starter-kit/blob/main/CONTRIBUTING.md) -to help new contributors add their expertise to the project. We include how to -[get in touch](https://github.com/bids-standard/bids-starter-kit/blob/main/CONTRIBUTING.md#get-in-touch), -[write in markdown](https://github.com/bids-standard/bids-starter-kit/blob/main/CONTRIBUTING.md#writing-in-markdown), -[submit a pull request](https://github.com/bids-standard/bids-starter-kit/blob/main/CONTRIBUTING.md#making-a-change-with-a-pull-request) -and explanations of where to put -[useful code or links in the wiki](https://github.com/bids-standard/bids-starter-kit/blob/main/CONTRIBUTING.md#where-to-start-wiki-code-and-templates). +about the project during any relevant events. +Online, we created an animated video +to summarize the general idea and make the first step that much easier. +We developed +[extensive contribution guidelines](../../bids_github/CONTRIBUTING.md) +to help new contributors add their expertise to the project. +We include how to get in touch, +write in markdown, +[submit a pull request](../../bids_github/CONTRIBUTING.md#making-a-change-with-a-pull-request) +and explanations of where to put useful code or links in the wiki. The licence on our repository is CC-BY and these guidelines have already been incorporated into other open source neuroimaging projects such as -[NiBetaSeries](https://nibetaseries.readthedocs.io/en/stable/). We also used the -[“good-first-issue” principle](https://github.com/bids-standard/bids-starter-kit/blob/main/CONTRIBUTING.md#where-to-start-issue-labels) +[NiBetaSeries](https://nibetaseries.readthedocs.io/en/stable/). +We also used the +“good-first-issue” principle to periodically leave small mistakes in our repository unfixed, such as a typo or an undefined term in the glossary. Then, we would send out a request and guide a new contributor through the process of using the repository. @@ -155,6 +155,4 @@ University, Canada Email: `parkpatrickj@gmail.com` -Github: [Park-Patrick](https://github.com/Park-Patrick) - Note: [INCF](https://incf.org) was the supporting umbrella organization for this BIDS Google Summer of Code project. diff --git a/docs/collaboration/reports/google_summer/2024-gsod.md b/docs/collaboration/reports/google_summer/2024-gsod.md index 219faff5..6d3099a3 100644 --- a/docs/collaboration/reports/google_summer/2024-gsod.md +++ b/docs/collaboration/reports/google_summer/2024-gsod.md @@ -1,10 +1,8 @@ # BIDS - INCF 2024 Google Season of Docs Case Study -:o: Umbrella Organization: [INCF](incf.org) - International Neuroinformatics Coordinating Facility - -:o: Project Organization: [BIDS](https://bids.neuroimaging.io/) - Brain Imaging Data Structure - -:o: Project Title: [Streamlining the BIDS Online Presence](https://www.incf.org/activities/gsod) +- Umbrella Organization: [INCF](https://www.incf.org) - International Neuroinformatics Coordinating Facility +- Project Organization: [BIDS](https://bids.neuroimaging.io/) - Brain Imaging Data Structure +- Project Title: [Streamlining the BIDS Online Presence](https://www.incf.org/activities/gsod) ## About BIDS @@ -27,7 +25,7 @@ Case Study Authors: This project was trying to improve the BIDS Online Presence, which consists primarily of its informational websites and the BIDS specification. We were able to migrate away from a multitude of websites and condense down to mainly the one “New” BIDS Website. -Overall the project was very succesful with a wealth of work put in by the tech writer and mentors. +Overall the project was very successful with a wealth of work put in by the tech writer and mentors. One lesson learned was we could have budgeted more for mentor time as it required more mentor time than anticipated. For other open-source volunteer or community-driven projects in need of coentralizing and streamlining their own online presence, this is a great program if you can define most of the tasks early on and dedicate mentor time alongside tech writer time during the project. @@ -47,8 +45,6 @@ Improvements from this project satisfied FAIR guiding principles and improved th ### Proposal Creation Process -*How did you come up with your Google Season of Docs proposal? What process did your organization use to decide on an idea? How did you solicit and incorporate feedback? Who participated in the process? How long did it take?* - The BIDS maintainers, steering group, and BIDS online presence working group all saw a need for BIDS to improve and centralize its online resources. One of the BIDS maintainers, Christine Rogers, had worked with Google Season of Docs before with success and suggested we partner with INCF to make progress on the website and documentation improvement projects. Primarily Christine and Eric Earl (chair of the BIDS online presence working group and another BIDS maintainer) drove the project proposal forward with prioritization oversight from the online presence working group. @@ -56,49 +52,14 @@ The brief proposal format was effectively developed through several consultative ### Budget - - - - - - - - - - - - - - - - - - - - - - - - - -
How much money did you ask for? - $6,500 USD -
How did you come up with this estimate? - Writer stipend: $5000 \ -Mentor stipend: $500 * 3 mentors -

-(following GSOC practice) -

How many hours of work did you budget for the project? - Writer: 4 h / wk \ -Mentors; 1 h / wk * 4 mentors = 4 h / wk -
How many hours of work were actually needed for the project? - Writer: 5 h / wk \ -Mentors: 1.5 h / week * 4 mentors = 6 h / wk -
What other expenses did you include in your budget? - None -
Did you run into any budget surprises during the project (for example mis-estimates)? If so, please explain. - Mentor time underestimated. Would allocate more for additional mentors or more mentor time. -
+| | | +| -------------------------------------------------------------------------------------------------------------| -------------------------------------------------------------------------------------------- | +| How much money did you ask for? | 6500$ USD | +| How did you come up with this estimate? | Writer stipend: 5000$
Mentor stipend: 500$ * 3 mentors
(following GSOC practice) | +| How many hours of work did you budget for the project? | Writer: 4 h / wk
Mentors: 1 h / wk * 4 mentors = 4 h / wk | +| How many hours of work were actually needed for the project? | Writer: 5 h / wk
Mentors: 1.5 h / week * 4 mentors = 6 h / wk | +| What other expenses did you include in your budget? | None | +| Did you run into any budget surprises during the project (for example mis-estimates)? If so, please explain. | Mentor time underestimated. Would allocate more for additional mentors or more mentor time. | ### Technical Writer Recruitment @@ -131,85 +92,22 @@ And finally, October and November brought the BIDS Impact page together to wrap #### Planned Deliverables - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Deliverable - % Complete - Relevant Links - Notes -
Consolidate into one website - 100% - https://bids-website.readthedocs.io/ - Dev site - Planning launch in Q1 2025 to replace the old BIDS website at https://bids.neuroimaging.io/ -
Implement a more friendly main website structure and improve navigation - 100% - https://github.com/bids-standard/bids-website/blob/main/mkdocs.yml#L88 - User feedback indicates this created significant improvement ( See: Metrics) -
New BIDS Impact page - 100% - https://bids-website.readthedocs.io/en/latest/impact/index.html - Expanded and improved with more metrics and relevant context -
Categorize and add clear summaries to each webpage - 100% - https://github.com/bids-standard/bids-website/pull/498 - Each page now has a lead paragraph -
Synthesized and enabled gathering of user-feedback and user-testing - 100% - - Developed a follow-up survey and collated findings from all community feedback. Helped synthesize metrics and inputs for annual community presentation. -
Add a feedback form within the main website - 100% - - Giscus at the bottom of the front page was re-scoped and implemented by a mentor -
+| Deliverable | % Complete | Relevant Links | Notes | +| ----------------------------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Consolidate into one website | 100% | [new BIDS wesbite](https://bids-website.readthedocs.io/) | Dev site - Planning launch in Q1 2025 to replace the old BIDS website at | +| Implement a more friendly main website structure and improve navigation | 100% | [mkdocs TOC configuration](https://github.com/bids-standard/bids-website/blob/main/mkdocs.yml#L88) | User feedback indicates this created significant improvement ( See: [Metrics](#metrics)) | +| New BIDS Impact page | 100% | [new impact page](https://bids-website.readthedocs.io/en/latest/impact/index.html) | Expanded and improved with more metrics and relevant context | +| Categorize and add clear summaries to each webpage | 100% | [Pull request #498](https://github.com/bids-standard/bids-website/pull/498) | Each page now has a lead paragraph. | +| Synthesized and enabled gathering of user-feedback and user-testing | 100% | | Developed a follow-up survey and collated findings from all community feedback. Helped synthesize metrics and inputs for annual community presentation. | +| Add a feedback form within the main website | 100% | | Giscus at the bottom of the front page was re-scoped and implemented by a mentor | + +The above table summarizes the many changes across several repositories (pull requests linked here): -The above table summarizes the many changes across several repositories (PRs linked here): +- [BIDS Website repo](https://github.com/bids-standard/bids-website/pulls?q=+is%3Apr+author%3Aiamdamion) and related repositories with content: -- [BIDS Website repo](https://github.com/bids-standard/bids-website/pulls?q=+is%3Apr+author%3Aiamdamion) and sub/related repos with content: -- [BIDS-Apps Repo](https://github.com/bids-apps/bids-apps.github.io/pull/140) -- [BIDS Execution Spec](https://github.com/bids-standard/execution-spec/pull/24) -- [BIDS Extensions repo](https://github.com/bids-standard/bids-extensions/pull/35) + - [BIDS-Apps Repo](https://github.com/bids-apps/bids-apps.github.io/pull/140) + - [BIDS Execution Spec](https://github.com/bids-standard/execution-spec/pull/24) + - [BIDS Extensions repo](https://github.com/bids-standard/bids-extensions/pull/35) #### Unplanned Deliverables diff --git a/docs/getting_started/folders_and_files/metadata/json.md b/docs/getting_started/folders_and_files/metadata/json.md index d5c91f20..957e778f 100644 --- a/docs/getting_started/folders_and_files/metadata/json.md +++ b/docs/getting_started/folders_and_files/metadata/json.md @@ -181,7 +181,7 @@ Remember to install and call a package before using it. - are no longer than 63 characters. Many parts of JSON files are often loaded as -[`structures`](https://nl.mathworks.com/help/matlab/ref/struct.html) by MATLAB / Octave, +[`structures`](https://www.mathworks.com/help/matlab/ref/struct.html) by MATLAB / Octave, where a `key` in a JSON file becomes `fieldname` in that structure. Here is an example with a simple `example.json` diff --git a/md_link_check_config.json b/md_link_check_config.json index b01988c4..78b08386 100644 --- a/md_link_check_config.json +++ b/md_link_check_config.json @@ -26,6 +26,12 @@ }, { "pattern": "^https://human-organ-atlas.esrf.eu.*" + }, + { + "pattern": "^https://www.mathworks.com.*" + }, + { + "pattern": "^https://www.seedsforchange.org.uk/consensus" } ], "timeout": "20s",