in-toto / layout-web-tool

A flask app that helps to create, modify and visualize in-toto layouts.
MIT License
2 stars 8 forks source link

Streamline and maybe move installation instructions #16

Open aaaaalbert opened 7 years ago

aaaaalbert commented 7 years ago

The wizard's landing page asks to pip install in-toto from GitHub. It should probably suggest to do so in a virtualenv to keep it nicely isolated from the rest of the probably-fragile local Python install.

aaaaalbert commented 7 years ago

To clarify, IMHO most projects now default to including virtualenv in their installation instructions, and let people that don't want to use it figure it out.

lukpueh commented 7 years ago

More installation clarification is needed, e.g. about supported Python version - https://github.com/in-toto/layout-web-tool/pull/14#discussion_r137350948, supported operating systems and system requirements.

lukpueh commented 7 years ago

There was the suggestion to postpone the installation instruction until the user actually needs in-toto, so as to not discourage the user with such a hurdle in the beginning.

I think that is a good idea, but should at least mention in the very beginning that the wizard will require the user to install in-toto, so that it does not come as a surprise.