Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: restructure readme #46

Merged
merged 3 commits into from
May 23, 2022
Merged

docs: restructure readme #46

merged 3 commits into from
May 23, 2022

Conversation

danielgordon-switch-ev
Copy link
Contributor

This PR reorganizes the readme so that it better presents the information the user needs to get up and running locally.

It also changes one of the make commands to use Poetry rather than pip, and adds a recommendation to use poetry shell in local development -- this automatically activates the appropriate virtual environment once it is created.

One question @tropxy @shalinnijel2 : Was docker-compose.prod.yml intended to be used for production at some point? I understand we're not going to be deploying with Docker -- is this obsolete?

@HugoJP1
Copy link

HugoJP1 commented May 23, 2022

This looks fine to me, but probably needs a closer look from someone closer to the project @shalinnijel2 @tropxy

Comment on lines +72 to +75
poetry install

poetry-shell:
poetry shell
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As this could fail if poetry is not available, would it perhaps be better if there is a 'pip install poetry' before 'poetry install'?

Makefile Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
The following command provides a helper for the script usage:

```bash
$ cd iso15118/shared/pki/
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice...helps with copy pasting to terminal from readme...

@danielgordon-switch-ev danielgordon-switch-ev force-pushed the docs/restructure-readme/1924 branch from 9c4e0d6 to 9f2ef0a Compare May 23, 2022 15:32
@tropxy tropxy force-pushed the docs/restructure-readme/1924 branch from 9f2ef0a to f103a78 Compare May 23, 2022 22:39
@tropxy tropxy merged commit f40c7b0 into master May 23, 2022
@tropxy tropxy deleted the docs/restructure-readme/1924 branch May 24, 2022 08:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants