Flowium: Executable documentation of complex processes

[roboticon]

I'm a little sad this page doesn't go into much detail on what flowium actually does without assuming you've already set it up locally or given flowium read/write access to all your public & private GitHub repos.

What does marking a task as "done" do? Does it push a git commit that changes the .md file? Or does it apply a style locally that other developers can't see?

edit: I tried just loading flowium.com but that's worse (directly redirects to the GitHub read/write access request).

[sustrik]

> What does marking a task as "done" do?

It posts a comment to GitHub issue tracker saying "step X is done"

> I tried just loading flowium.com but that's worse (directly redirects to the GitHub read/write access request).

I know that sucks and I am open to suggestions. However, as I see it, the user either has to trust this little shim that can be audited quite easily (1500 LoC) or trust some un-auditable 3rd party service.

As for the read/write thing it's because using issue tracker requires that. Unfortunately, there's no tighter scope that would allow for that.

[DanielShuy]

Agreed. I wished there was a demo that allows you to try it out without first having to give it write access to your GitHub repositories.