diff --git a/docs/conf_extlinks.py b/docs/conf_extlinks.py index 3002178b3..e6565f3c3 100644 --- a/docs/conf_extlinks.py +++ b/docs/conf_extlinks.py @@ -5,6 +5,8 @@ "pynwb-docs": ("https://pynwb.readthedocs.io/en/stable/%s", "%s"), "matnwb-src": ("https://github.com/NeurodataWithoutBorders/matnwb/%s", "%s"), "nwb-overview": ("https://nwb-overview.readthedocs.io/en/latest/%s", "%s"), + "guide-issues": ("https://github.com/NeurodataWithoutBorders/nwb-guide/issues/%s", "%s"), + "request-format-support": ("https://github.com/catalystneuro/neuroconv/issues/new?assignees=&labels=enhancement%%2Cdata+interfaces&projects=&template=format_request.yml&title=%%5BNew+Format%%5D%%3A+%s", "%s"), "path-expansion-guide": ("https://neuroconv.readthedocs.io/en/main/user_guide/expand_path.html%s", "%s"), "dandi-staging": ("https://gui-staging.dandiarchive.org/%s", "%s"), "dandi-archive": ("https://dandiarchive.org/%s", "%s"), diff --git a/docs/tutorials/multiple_sessions.rst b/docs/tutorials/multiple_sessions.rst index 4d1392d85..cee658e13 100644 --- a/docs/tutorials/multiple_sessions.rst +++ b/docs/tutorials/multiple_sessions.rst @@ -29,7 +29,7 @@ This page helps you automatically identify source data for multiple subjects / s File locations are specified as **format strings** that define source data paths of each selected data format. .. note:: - Format strings are one component of NeuroConv's **path expansion language**, which has some nifty features for manually specifying complex paths. Complete documentation of the path expansion feature of NeuroConv can be found :path-expansion-guide:`here <>` . + Format strings are one component of NeuroConv's **path expansion language**, which has some nifty features for manually specifying complex paths. Complete documentation of the path expansion feature of NeuroConv can be found :path-expansion-guide:`here <>`. While you don’t have to specify format strings for all of the pipeline’s data formats, we’re going to find all of our data here for this tutorial. You'll always be able to confirm or manually select the final paths on the Source Data page later in the workflow. diff --git a/docs/tutorials/next_steps.rst b/docs/tutorials/next_steps.rst index daf330370..01d9430b6 100644 --- a/docs/tutorials/next_steps.rst +++ b/docs/tutorials/next_steps.rst @@ -1,13 +1,21 @@ What's Next? -======================================= +============ +Congratulations on finishing your first set of conversions using the NWB GUIDE using example data! The next big step is to make a pipeline for your own data. -Considerations when Using Your Own Data ---------------------------------------- -When using your own data, there are a few things to consider: + +To submit any feedback on the tutorial or your experience with the GUIDE, feel free to open an :guide-issues:`issue <>` on our GitHub page. + +If you do not see your data format listed on the Data Formats page or our :doc:`support table ` , please submit a request using :request-format-support:`this form <>`. + + +Considerations for Real-World Use +--------------------------------- +When using the GUIDE to convert data from your own experiments, there are a few things to keep in mind... Choosing an Output Location ^^^^^^^^^^^^^^^^^^^^^^^^^^^ - Choosing a good output location is important for two reasons, namely **conversion speed** and **disk space**. +Choosing a good output location is important for two reasons, namely **conversion speed** and **disk space**. - 1. SSDs will be much faster than HDDs. We’d recommend moving the output location to an SSD if available. - 2. If you don’t have much disk space available on your main drive, we recommend changing the output location to a drive that has ample space. +1. SSDs will be much faster than HDDs. We’d recommend moving the output location to an SSD if available. +2. On-board (PCI slot) disk drives will be much faster than most conventional external USB drives. We recommend using an on-board disk drive whenever possible. +3. If you don’t have much disk space available on your main drive, we recommend changing the output location to a drive that has ample space.