docs: Add paragraph about @ operator

docs/cli.md

@@ -304,6 +304,10 @@ poetry add "pendulum>=2.0.5"
 poetry add pendulum==2.0.5
 ```
 
+{{% note %}}
+See the [Dependency specification]({{< relref "dependency-specification#using-the--operator" >}}) page for more information about `@` operator.
+{{% /note %}}
+
 If you try to add a package that is already present, you will get an error.
 However, if you specify a constraint, like above, the dependency will be updated
 by using the specified constraint.

docs/dependency-specification.md

@@ -84,6 +84,40 @@ You can specify the exact version of a package.
 This will tell Poetry to install this version and this version only.
 If other dependencies require a different version, the solver will ultimately fail and abort any install or update procedures.
 
+### Using the `@` operator
+
+When adding dependencies via CLI `add` command, you can use `@` operator.
+This is understood the same way as `==` specifier, with one difference. After the `@` operator, you can use any
+specifiers that are valid in `pyproject.toml` file. For example:
+
+```shell
+poetry add django@^4.0.0
+```
+
+Would translate to the following entry in `pyproject.toml`:
+```toml
+Django = "^4.0.0"
+```
+
+This operator, can also be used with in conjunction with word `latest`, to specify latest available version.
+For example:
+```shell
+poetry add django@latest
+```
+
+Would translate to the following entry in `pyproject.toml`:
+```toml
+Django = "^4.0.5"
+```
+
+#### Extras
+
+To use extras for package using the `@` operator, formula is: `package[extra]@version`, for example:
+
+```shell
+poetry add django[bcrypt]@^4.0.0
+```
+
 ## `git` dependencies
 
 To depend on a library located in a `git` repository,