style (next-steps): standardizing image embed syntax, image filenames, and interactive section formatting (see #58)

Author: njlyon0

mod_next-steps.qmd

@@ -32,7 +32,10 @@ No specific preparation required.
 
 Depositing your assembled dataset in a public repository ensures that others can find it and (importantly) cite it effectively. Using a repository with high-quality, machine-readable metadata goes a long way toward ensuring that it is usable and appropriately credited. Unless there is a specific reason not to use the [Environmental Data Initiative (EDI) repository](https://edirepository.org/), it is what we recommend for LTER-related data because EDI serves some of the most "findable, accessible, interoperable, and reusable" (FAIR) environmental data available. Also, since EDI serves the vast majority of LTER data, co-locating your synthesis data makes it more available to users seeking similar types of data.
 
-[![Authors provide data and metadata to EDI through ezEML. EDI checks for metadata completeness, packages, and serves the data to users. Credit: EDI](images/the-data-package.png){fig-alt="a pipeline from data and metadata, through quality report and resource map to finished data package."}](https://edirepository.org/resources/the-data-package)
+<p align="center">
+<img src="images/figure_data-package.png" alt="a pipeline from data and metadata, through quality report and resource map to finished data package" width="100%"/>
+<figcaption>Authors provide data and metadata to EDI through ezEML. EDI checks for metadata completeness, packages, and serves the data to users. Credit: Environmental Data Initiative</figcaption>
+</p>
 
 The Environmental Data Initiative has developed the [ezEML app](https://edirepository.org/resources/creating-metadata-for-publication#ezeml:~:text=create%20EML%20metadata.-,ezEML,-ezEML%20is%20a) to simplify the publication of datasets with high-quality metadata. The form-based tool leads users through creating and validating Ecological Metadata Language (EML) documents, a standard that can describe many types of data and their use cases, and then submitting them to the repository with accompanying data files. To prepare for submitting your data you'll need to gather some information and make a few decisions.
 
@@ -50,13 +53,13 @@ The Environmental Data Initiative has developed the [ezEML app](https://edirepos
 
 -   **Sharing code**: Chances are, your code is already public on GitHub (and hopefully, well documented), but you'll want to create a persistent reference to the version of the code that you used to conduct *this* analysis. One way to go is to package your code along with your data on EDI. That approach makes the code findable, because it is right there with the data, but the code remains static, and it can be difficult to represent the software package structure and release history. Many researchers now prefer to release their GitHub repository [code on Zenodo](https://docs.github.com/en/repositories/archiving-a-github-repository/referencing-and-citing-content) and reference the specific release with their dataset in EDI or another repository. This allows continued development of code in the repository, while linking together the dataset and the code for creating or analyzing it. This approach is great for synthesis groups that will continue adding new data, analyses, or publications in the future.
 
-## Promote your dataset (and other products)
+## Promote Your Dataset (and Other Products)
 
 Now that potential users and collaborators can find your dataset, how will they? Data in EDI are easily found through EDI, DataONE and Google data search, but many potential users won't even know what they should be searching for. "Build it and they will come" doesn't work much better for data than it does in other realms – at least not yet. Eventually, AI-driven search tools for researchers may improve the situation, but for now it's still important to garner the attention of individuals. Who do you want to reach? Who you want to reach and what you want them to do with the data, paper, or other tool will influence how you spend the (likely quite limited) time you have to spend on promotion.
 
 Want to reach community ecologists? Modelers? Land managers? Teachers? The choice will affect both where and how you promote the work. The choices here are endless, but the examples below illustrate the principle.
 
--   **Data papers** are essentially an extended version of your metadata, published in the form of a paper, and referencing the published dataset. They are great for calling attention to a high-value dataset, especially when it crosses disciplinary boundaries. Data papers are most appropriate when you want to reach people, such as modelers, who will use the dataset directly rather than your analysis and interpretation. [*Earth System Science Data*](https://www.earth-system-science-data.net/), [*Biodiversity Data Journal*](https://bdj.pensoft.net/), and [*Scientific Data*](https://www.nature.com/sdata/) all focus on data papers and are relevant for environmental science.
+-   **Data papers** are essentially an extended version of your metadata, published in the form of a paper, and referencing the published dataset. They are great for calling attention to a high-value dataset, especially when it crosses disciplinary boundaries. Data papers are most appropriate when you want to reach people, such as modelers, who will use the dataset directly rather than your analysis and interpretation. [*Ecology*](https://esajournals.onlinelibrary.wiley.com/journal/19399170), [*Earth System Science Data*](https://www.earth-system-science-data.net/), [*Biodiversity Data Journal*](https://bdj.pensoft.net/), and [*Scientific Data*](https://www.nature.com/sdata/) all focus on data papers and are relevant for environmental science.
 
 -   **Scientific conferences**. Talks and posters at scientific conferences such as the Ecological Society of America or the American Geophysical Union are the go-to option for promoting your work to researchers in your field. But if you want people to use your dataset, not just admire your brilliance, you might consider running a symposium that allows more time for discussion or a workshop to get colleagues working with the data in a hands-on way. Note that the deadlines for proposing workshops and symposium sessions are often much earlier than for individual talks and posters.
 
@@ -73,53 +76,46 @@ Whatever tactics you pursue, spend a little time as a group agreeing on the lang
 Beyond preserving and promoting the current work, there are a few things you can do to prepare for the new research opportunities that it can generate. Ideally, the group has been tracking spin-off ideas as they come up. It's impractical to chase them all down in the moment, but recording them, with just a few sentences of context and explanation, will help to resurface the inspiration at a later date.
 
 <figure >
-<img src="images/mind-map.png" alt="linked concepts around a central theme" width="50%" align="right">
+<img src="images/figure_mind-map.png" alt="linked concepts around a central theme" width="50%" align="right">
 </figure>
 
 Now is the time to pull those ideas out of mothballs or, alternatively, return to the mind maps we made in the [project management session](https://lter.github.io/ssecr/mod_project-mgmt.html) to unearth some new ones.
 
 This year, you've tackled one, maybe two, of the relationships on that mind map. But chances are that the data you've assembled sheds light on several more. In this project group discussion, we'll take some time to identify and explore a few of them. 
 
-:::panel-tabset
-### Discussion: Preparing to Propose
+:::{.callout-warning icon="false"}
+#### Discussion: Preparing to Propose
 
-**Individually (15 minutes)**
+**Part 1 - Individually**
 
 -  Pull up your running list of project ideas, the mind map you generated in the project management session, or start a new mind map with your current project theme at the center.
 -  Come up with a related research idea that capitalizes on the data you've assembled. Try focusing on upstream controls, downstream impacts or modifying factors to spur your creativity. It doesn't have to be Nobel-worthy, it's just for this exercise.
 -  Identify what additional data or analyses would be needed to clarify the nature and scale of the relationship  
 -  How might a change in our understanding of that relationship affect how we understand other processes? 
 
-**In pairs (5 minutes each)**
+**Part 2 - In Pairs**
 
 -  Explain your idea, what you would need, and where it might lead
 
-**Still in pairs (5 minutes)**
+**Part 3 - Still in Pairs**
 
 -  For each of your projects, brainstorm a list of people (individuals, groups, roles, agencies) who care about those changes or that might benefit from or be hurt by them.
+- For example, say your original project was focused on understanding what factors influence the long term immobilization of soil carbon during decomposition. Spin-off ideas might look at:
+    -  Additional controlling factors that you couldn't include in the first effort; 
+    -  A wider range of ecosystems; 
+    -  The role of variability (not only temperature, for example, but also the frequency of freeze-thaw cycles);
+    -  The effect of the same factors on the mobilization of nutrients in soil; or 
+    -  Scaling the analysis to forecast the impact on carbon sinks under alternative climate scenarios. 
+- In addition to the standard science funding agencies such as NSF, NASA, DOE, or USDA, other interested parties: farmers, fertilizer suppliers, extension professionals, carbon markets, climate modelers...
+    - Note these along with the nature of their interest.
 
-For example, say your original project was focused on understanding what factors influence the long term immobilization of soil carbon during decomposition. Spin-off ideas might look at:
-
--  additional controlling factors that you couldn't include in the first effort; 
--  a wider range of ecosystems; 
--  the role of variability (not only temperature, for example, but also the frequency of freeze-thaw cycles);
--  the effect of the same factors on the mobilization of nutrients in soil; or 
--  scaling the analysis to forecast the impact on carbon sinks under alternative climate scenarios. 
-
-In addition to the standard science funding agencies such as NSF, NASA, DOE, or USDA, other interested parties: farmers, fertilizer suppliers, extension professionals, carbon markets, climate modelers...
-
-Note these along with the nature of their interest.
-
-**In full group (5-10 minutes)**
+**Part 4 - In Full Group**
 
 Discuss how ideas came together and what kinds of audiences were identified. 
 
 :::
 
-<figure >
-<img src="images/pocket.png" alt="a garment pocket with money poking out of it" width="25%" align="right">
-<figcaption background-color="white"></figcaption>
-</figure>
+<img src="images/icon_pocket.png" alt="a garment pocket with money poking out of it" width="25%" align="right"/>
 
 When thinking about how to support a research program, strategy (setting goals and making plans to achieve them) is often contrasted with an opportunistic approach. But really, it's essential to apply a bit of both. The list of people and agencies you generated from this exercise serves as a starting point for exploring funding opportunities. When you find an opportunity that intersects with a problem that you have the tools, skills, and data to tackle, that's when you spring into action, building on knowledge gaps that you've already identified. 
 
@@ -130,7 +126,7 @@ When you have an idea that you're excited about, one great practice is to develo
 A pocket proposal serves as a great starting point for the research statement you'll need for a faculty job search. 
 :::
 
-## Crafting a compelling proposal
+## Crafting a Compelling Proposal
 
 No matter your audience, you need to put yourself in their shoes. Decision makers spend their limited resources to meet _their_ goals, no matter how exciting they find your science. Of course you need to follow their guidelines, but take it a step further. Think about who this agency serves. Read up on their past awards. Get inside their heads.
 
@@ -155,9 +151,10 @@ Even for an individual donor, you'll want to have a list of talking points that
 
 It can be intimidating, but it is immensely helpful to ask for feedback from experienced colleagues at various stages of proposal development. Be sure to specify what kind of feedback would be useful to you and to give them a (reasonable) deadline.
 
-:::panel-tabset
+:::{.callout-warning icon="false"}
+#### Discussion: Revisit Group Authorship Agreement
 
-##  Group Discussion: Revisit your Authorship Agreement
+With a partner/group discuss (some of) the following questions:
 
 Anytime a project undergoes a major transition, it's a good idea to revisit the approach to authorship. An agreement that worked well for an organized project with fixed membership may not be as appropriate for spin-off projects, spearheaded by individual team members and involving rotating groups of collaborators. 
 
@@ -169,28 +166,24 @@ Break out into project groups and discuss the following questions as they might
 -  Whether a team member wants to stay involved or not, what are the expectations for how members of this group are credited on future related projects?
 
 Record the decisions and preserve for further discussion as projects evolve.
+
 :::
 
 ## Additional Resources
 
-Schimel, Joshua. [Writing Science: How to Write Papers That Get Cited and Proposals That Get Funded](https://global.oup.com/academic/product/writing-science-9780199760244?cc=us&lang=en&). Oxford University Press. 2011.
-
-Resource list of funding sources and search tools
-
--  [NSF funding search](https://www.nsf.gov/funding/opportunities) 
--  [DoE funding search](https://www.energy.gov/science/office-science-funding-opportunities)
--  [Cooperative Ecosystem Studies Units (CESU)](http://www.cesu.psu.edu/fundopps/fundopps.htm)
--  [International Synthesis Consortium](https://synthesis-consortium.org/) is an umbrella group for synthesis centers across disciplines
--  [Science for Nature and People Partnership](https://snappartnership.net/)
--  [Pivot-RP](https://clarivate.com/academia-government/scientific-and-academic-research/research-funding-analytics/pivot-rp-funding/), a Clarivate product that curates funding opportunities across public and private sources. Pivot is a paid product, but most research universities have access.
--  [Philanthropy News Digest](https://philanthropynewsdigest.org/rfps) publishes a feed of requests for proposals from private foundations. It can be filtered by topic, location, and other keywords. Awards are small, relative to federal funding agencies and topics tend to be applied.
--  [Community Foundations](https://cof.org/foundation-type/community-foundations) fund project with clear benefits to a local community. 
--  State environmental and fish and wildlife agencies often have a need for science to inform their conservation activities
-
 ### Papers & Documents
 
 -   Deutsch L., *et al.*, [Leading Inter- and Transdisciplinary Research: Lessons from Applying Theories of Change to a Strategic Research Program](https://www.sciencedirect.com/science/article/pii/S146290112100054X?via%3Dihub). **2021**. *Environmental Science & Policy*
+- Schimel, J. [Writing Science: How to Write Papers That Get Cited and Proposals That Get Funded](https://global.oup.com/academic/product/writing-science-9780199760244?cc=us&lang=en&). **2011**.
 
 ### Websites
 
--  [Research proposal examples from every science field](https://peerrecognized.com/research-proposal-examples-for-every-science-field/). The site does a nice job of describing the key pieces of a proposal. If you're looking for examples, you can probably find colleagues who will share their more closely-related proposals with you. 
+-  [Research proposal examples from every science field](https://peerrecognized.com/research-proposal-examples-for-every-science-field/).
+-  [NSF funding search](https://www.nsf.gov/funding/opportunities) 
+-  [DoE funding search](https://www.energy.gov/science/office-science-funding-opportunities)
+-  [Cooperative Ecosystem Studies Units](http://www.cesu.psu.edu/fundopps/fundopps.htm) (CESU)
+-  [International Synthesis Consortium](https://synthesis-consortium.org/) is an umbrella group for synthesis centers across disciplines
+-  [Science for Nature and People Partnership](https://snappartnership.net/)
+-  [Pivot-RP](https://clarivate.com/academia-government/scientific-and-academic-research/research-funding-analytics/pivot-rp-funding/), a Clarivate product that curates funding opportunities across public and private sources. Pivot is a paid product, but most research universities have access
+-  [Philanthropy News Digest](https://philanthropynewsdigest.org/rfps) publishes a feed of requests for proposals from private foundations. It can be filtered by topic, location, and other keywords. Awards are small, relative to federal funding agencies and topics tend to be applied
+-  [Community Foundations](https://cof.org/foundation-type/community-foundations) fund project with clear benefits to a local community