Skip to content

Commit

Permalink
Merge pull request #28 from chaselgrove/first-personas
Browse files Browse the repository at this point in the history
Rewrite getting started stories in first-person
  • Loading branch information
chaselgrove authored Nov 22, 2024
2 parents be74b3a + fe4d1d9 commit 3e5b8e4
Showing 1 changed file with 24 additions and 16 deletions.
40 changes: 24 additions & 16 deletions content/resources/getting-started/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Who would you like to hear from?
<img src="/images/sarah.jpg" alt="Sarah" style="width: 150px; height: auto; object-fit: cover;">
</a>
<p>
Hi, I’m Sarah. I’m an early to mid-career researcher. I’m interested in applying best practices to my day-to-day research workflow.
Hi, I’m Sarah. I’m an early- to mid-career researcher. I’m interested in applying best practices to my day-to-day research workflow. <a href="#sarah">Read more.</a>
</p>
</div>

Expand All @@ -40,7 +40,7 @@ Who would you like to hear from?
<img src="/images/richard.jpg" alt="Richard" style="width: 150px; height: auto; object-fit: cover;">
</a>
<p>
Hi, I’m Richard. I’m a research software engineer. I want to incorporate more standards into the technical operations of my lab and also learn more about how to effectively share workflows with his clients.
Hi, I’m Richard. I’m a research software engineer. I want to incorporate more standards into the technical operations of my lab and also learn more about how to effectively share workflows with my clients. <a href="#richard">Read more.</a>
</p>
</div>

Expand All @@ -49,7 +49,7 @@ Who would you like to hear from?
<img src="/images/john.jpg" alt="John" style="width: 150px; height: auto; object-fit: cover;">
</a>
<p>
Hi, I’m John. I am a university-based computational neuroscientist and teacher. I would like to see what resources ReproNim can offer for my teaching about rigor and reproducibility.
Hi, I’m John. I'm a university-based computational neuroscientist and teacher. I would like to see what resources are available for my teaching about rigor and reproducibility. <a href="#john">Read more.</a>
</p>
</div>

Expand All @@ -58,17 +58,19 @@ Who would you like to hear from?
<img src="/images/evelyn.jpg" alt="Evelyn" style="width: 150px; height: auto; object-fit: cover;">
</a>
<p>
Hi, I’m Evelyn. I am the director of a multi-center distributed project. My interest is in harmonizing the research being performed at several sites.
Hi, I’m Evelyn. I'm the director of a multi-center distributed project. My interest is in harmonizing the research being performed at several sites. <a href="#evelyn">Read more.</a>
</p>
</div>

## Sarah the early-to-mid career researcher
## Sarah

<img src="/images/sarah.jpg" alt="Sarah" style="width: 250px; height: auto;">

Sarah is fluent in modern technologies and comfortable both at the bench and behind a computer. She spends her days engaged in the hands-on aspects of studies. As she builds her career, she is concerned with keeping up-to-date with the latest trends and tools, but she doesn't dwell on technology for its own sake. Efficiency is important to her, but not if it sacrifices rigor.
I’m Sarah, an early- to mid-career researcher. I’m interested in applying best practices to my day-to-day research workflow.

**Sarah’s interests**: I would like support for making my workflow development more efficient: How do I go from my 'garden path' trial workflow development, lock into a 'final' workflow, and then efficiently apply this workflow to my complete dataset. My workflow might change, so I'd like to efficiently update and re-apply the new workflow. I've heard 'versioning' will be important for this, but I'm not handy with these technologies.vPublishing my data would be nice, for some additional impact and complying with the NIH data sharing mandate support.
I'm fluent in modern technologies and comfortable both at the bench and behind a computer, and I spend my days engaged in the hands-on aspects of studies. As I build my career, I want to keep up-to-date with the latest trends and tools, but I don't dwell on technology for its own sake. Efficiency is important, but not if it sacrifices rigor.

I would like support for making my workflow development more efficient: How do I go from my 'garden path' trial workflow development, lock into a 'final' workflow, and then efficiently apply this workflow to my complete dataset? My workflow might change, so I'd like to efficiently update and re-apply the new workflow. I've heard versioning will be important for this, but I'm not handy with these technologies. Publishing my data would be nice for some additional impact and complying with the NIH data sharing mandate support.

**How can ReproNIM help?**

Expand All @@ -88,13 +90,15 @@ ReproNIM can help Sarah learn more about data and software management and other
* Principle: Publishing re-executable paper
* Foundations: Standards, Annotation

## Richard the software engineer
## Richard

<img src="/images/richard.jpg" alt="Richard" style="width: 250px; height: auto;">

Richard is responsible for developing the software in support of his lab’s research. High-level requirements are given to him, but he then has freedom in deciding how to implement solutions. He does not code exclusively but researches and plans his work: he must determine how to balance software engineering best practices with the limited resources available for research software engineering.
Hi, I’m Richard, a research software engineer. I want to incorporate more standards into the technical operations of my lab and also learn more about how to effectively share workflows with my clients.

I'm responsible for developing the software in support of my lab’s research. I'm given high-level requirements but I then have the freedom to decide how to implement solutions. I don't code exclusively but spend time researching and planning my work since I have to balance software engineering best practices with the limited resources available for research software engineering.

**Richard’s interests**: Richard would like to generate software products that participate in community standards for data ingestion and export. He is aware of BIDS for standard input data representation, he needs to learn about 'output standards' such as BIDS derivatives and standardized output description (e.g. NIDM). He can be convinced that containerizing his software products can make them easier to deliver to his local clients (and for them to share with others who want to reproduce their work) and easier to support, compared to a bare metal software solution.
I would like to generate software products that incorporate community standards for data ingestion and export. I'm aware of BIDS for standard input data representation, but I need to learn about output standards such as BIDS derivatives and standardized output descriptions (like NIDM). I have heard that containerizing software can make it easier to deliver it to my local clients (and for them to share with others who want to reproduce their work) and easier to support compared to a bare metal software solution.

**How can ReproNIM Help?**

Expand All @@ -110,13 +114,15 @@ ReproNIM can help Richard learn how standards such as BIDs and NIDM can help wit
* Advanced data and software management: Datalad containers/run \+, YODA principles
* More use cases are available through our ReproGuide

## John the computational neuroscientist and teacher
## John

<img src="/images/john.jpg" alt="John" style="width: 250px; height: auto;">

John is a university-based computational neuroscientist and teacher both a research lab and teaching responsibilities. He would like his lab members to understand and utilize principles of re-executable annotated workflows, and is wondering whether whether the Fellowship program might be appropriate for someone in his lab (perhaps a way to train others in the lab thereafter). As a teacher, he is interested in broadly educating his students on reproducibility, including exposure to key concepts, tools and educational materials.
Hi, I’m John. I'm a university-based computational neuroscientist and teacher. I would like to see what resources are available for my teaching about rigor and reproducibility.

**John** is interested in whether ReproNim provides up to date teaching materials that he might use in his own teaching, and also interested in resources that might help his students and/or lab.
I have both lab and teaching responsibilities. I'd like my lab members to understand and utilize principles of re-executable annotated workflows. I also wonder whether whether the ReproNim fellowship program might be appropriate for someone in my lab (perhaps as a way to train others in the lab thereafter). As a teacher, I'm interested in broadly educating my students on reproducibility, including exposure to key concepts, tools, and educational materials.

I'm interested in whether ReproNim provides up-to-date teaching materials that I can use in my own teaching. I'm also interested in resources that might help my students and/or lab.

**How can ReproNim Help?**

Expand All @@ -130,13 +136,15 @@ ReproNIM has also organized our tools and a set of step-by-step use cases in our

→ For hands on experience, his students can follow tutorials recommended for Sarah, Richard and Evelyn

## Evelyn the director of a multi-center project
## Evelyn

<img src="/images/evelyn.jpg" alt="Evelyn" style="width: 250px; height: auto;">

Evelyn is a researcher, and directs a multi-center distributed project. Her responsibilities include oversight for integrated data sharing and cross-site analyses within the project, as well as making all data ultimately publicly accessible and reusable. She is interested in options for facilitating and streamlining data acquisition, use and reuse for varied purposes, both within and beyond the bounds of the project itself. She has the authority and responsibility to make recommendations for infrastructure that would serve a multidisciplinary multi-site project well.
Hi, I’m Evelyn. I'm the director of a multi-center distributed project. My interest is in harmonizing the research being performed at several sites.

I've been a researcher my whole career, and now I direct a multi-center distributed project. My responsibilities include oversight for integrated data sharing and cross-site analyses within the project, as well as making all data ultimately publicly accessible and reusable. I'm interested in options for facilitating and streamlining data acquisition, use, and reuse for varied purposes, both within and beyond the bounds of the project itself. I have the authority and responsibility to make recommendations for infrastructure that would serve a multidisciplinary multi-site project well.

**Evelyn** thinks ReproNIM might address many of her priorities, but she would really like an end-to-end platform for data acquisition, data management and dissemination. She needs to distribute common analyses to her sites. She’d like it to be easy for the sites to give her results from this analysis that are easy to aggregate and harmonize. As her sites are also collecting their own subjects, she needs common demographic, clinical and behavioral data to be collected/shared in a way that is also easy to aggregate/harmonize.
I think ReproNim might address many of my priorities, but I'd really like an end-to-end platform for data acquisition, data management, and dissemination. I need to distribute common analyses to all of the project's sites. I'd like it to be easy for the sites to give me results from this analysis that are easy to aggregate and harmonize. As the sites are also collecting their own subjects, I need common demographic, clinical, and behavioral data to be collected and shared in a way that is also easy to aggregate and harmonize.

**How can ReproNIM help?**

Expand Down

0 comments on commit 3e5b8e4

Please sign in to comment.