"Basic Usage" guide may include specific instructions for existing poetry projects

[Zocker1999NET]

• [x] I have searched the issues of this repo and believe that this is not a duplicate.

Background

I am very new to poetry. I bumped into a first project I want to contribute to which uses poetry. So, to contribute to that project, I needed/wanted to learn on how to use poetry in the first place.

Issue

Currently, the basic usage guide seems targeted to users who discovered poetry and want to apply it to a project of their own (either a completely new one or an already existing one). That is different from when you first bump into a project, which already uses poetry, which IMO may happen more often.

So I think it makes sense to build another variant of a "basic usage" guide targeted to "users" which only want to contribute to a project using poetry, as most parts of the current "basic usage" don't apply to them. IMO it should answer following questions:

• Can poetry help you to set up a venv with all listed requirements?
  • yes
• How can you use it?
  • poetry install && poetry shell (mind shell will open a new subshell because …)
• What if I want to add another requirement?
  • poetry add or edit pyproject.toml manually
• Any other parts I might have missed which might be important to "users" as well
• What if I want to set up a new project?
  • link to the current basic usage guide

Alternative Solution

Maybe its good enough to add just a small section with an header explaining which parts of basic usage are most relevant if trying to use poetry on an already existing and configured project.

[dimbleby]

simply asking for docs improvements almost never works!

If this is important to you then advise contributing the change you would like to see.