go-textile
go-textile copied to clipboard
textileio
Better docs/description for `textile subscription` command
It is not clear from the docs, tour, and command line outputs that the subscription command ‘hangs’ while waiting for new output to print to the terminal. A more explicit mention of this in the docs/tour, plus a message printed to stdout might be useful?
Hi @doodlemania2 this is actually expected behavior. Essentially, subscribe is opening a streaming endpoint, and will output updates as they come. Generally it is most useful to call textile subscribe in a separate Terminal, and then run your various commands in your initial Terminal. The updates (say adding a file) should appear in your subscribe Terminal.
Oh! Well, that actually makes perfect sense - yes, suggest clarify that and maybe also output something like: "subscription active, now listening...ctl-c to cancel" or something.
Good suggestions! I’m going to rename this ticket and use it to update the docs etc 👍
Ooops, that's not actually what I created this ticket for, its related to what sander linked for. We need a more clear explanation of what this command does in the tour and docs. Renaming is a separate issue, but the clearer usage is pretty important here I think.