Next Steps Tutorial

[garrettmflynn]

This PR implements the Next Steps section of the tutorials.

[CodyCBakerPhD]

@garrettmflynn Looks like doc build is failing here

[garrettmflynn]

Hmm I'd found a few header mismatches. But I'm not sure what the persistent issue is coming from...

[CodyCBakerPhD]

Hmm I'd found a few header mismatches. But I'm not sure what the persistent issue is coming from...

Is it able to build successfully locally?

[garrettmflynn]

Yes though I'm using sphinx-build -b html docs/ _build/html/ and commenting out from conf_extlinks import extlinks, intersphinx_mapping in conf.py.

This method doesn't seem to care about things that RTD does—so I'm assuming this isn't really the correct way to test locally.

Can you confirm?

[CodyCBakerPhD]

and commenting out from conf_extlinks import extlinks, intersphinx_mapping in conf.py.

You shouldn't have to comment out anything

[garrettmflynn]

I have not been able to get around the following error:

  File "/Users/garrettflynn/Documents/GitHub/nwb-guide/docs/conf.py", line 5, in <module>
    from conf_extlinks import extlinks, intersphinx_mapping
ModuleNotFoundError: No module named 'conf_extlinks'

Any suggestions would be appreciated. I seem to be following all available similar documentation appropriately.

[CodyCBakerPhD]

Is your pwd inside the docs? Or +/- directory above/below somewhere

[garrettmflynn]

I'm running the command from the base of the repository. Running from docs didn't change anything.

Is that the same as the pwd?

[CodyCBakerPhD]

Did you install all the requirements in https://github.com/NeurodataWithoutBorders/nwb-guide/blob/main/docs/requirements-rtd.txt?

[garrettmflynn]

Yep no luck. Always the same resolution error for conf_extlinks