Open nsheff opened 4 months ago
I started a PR to polish the looper init
tutorial: #508
I've also created a PR to begin staging documentation changes for Looper 2.0.0 here: https://github.com/pepkit/pepspec/pull/34
The combination of these two PRs should close this issue with a 2.0.0 release.
Prompt user to create pipeline interface if it doesn't exist to make this even easier.
Have tutorial remind user that they add additional pipeline interfaces if desired.
Or add another loop to keep adding them.
for tutorials, we have: hello looper, but we need: tutorial on "your own project" (looper init tutorial). and hello looper should be simplified; the advanced stuff moves to "how to guides".
Ok, I've added some improvements to the looper init
tutorial. The user can now add multiple pifaces. Looper will also offer to spawn a generic pipeline interface (for each piface) if the piface does not exist.
I find the current documentation on how to configure a new project with looper to be really difficult. There are basically 2 problems:
It needs to be intuitive enough that we don't need so much documentation, and then, whatever minimal documentation remains needs to actually be correct.
Documentation
Just a few things I notice at first glance:
Getting started
I propose a new
looper init
utility that walks you through the process of creating a new looper project. I'll push an example script that will do this. I have it basically working, but I haven't been able to finish the pipestat configuration, which is too complex. It's not clear to me how looper and pypiper should share pipestat configuration. It seems like I should just configure pipestat, I guess in the.looper.yaml
file, and that should be it.looper init
and it will walk you through creating a config correctly.