docs(tutorial): add rust tutorial including openssl example #1155
Conversation
|
Also tested it on my windows machine. |
|
@nichmor Would you give this tutorial a go? |
yes, sure! |
docs/tutorials/rust.md
Outdated
| description = "Add a short description here" | ||
| authors = ["User Name <user.name@email.url>"] | ||
| channels = ["conda-forge"] | ||
| platforms = ["linux-64"] |
There was a problem hiding this comment.
I would add a comment that platforms will differ depends on your machine ( to not create confusion )
docs/tutorials/rust.md
Outdated
| pixi add rust | ||
| ``` | ||
|
|
||
| This will add the `rust` package to your `pixi.toml` file. |
There was a problem hiding this comment.
I would add a comment from where it will add
Co-authored-by: Tim de Jager <tdejager89@gmail.com>
Co-authored-by: Tim de Jager <tdejager89@gmail.com>
Co-authored-by: Tim de Jager <tdejager89@gmail.com>
Co-authored-by: Tim de Jager <tdejager89@gmail.com>
Co-authored-by: Tim de Jager <tdejager89@gmail.com>
Co-authored-by: Tim de Jager <tdejager89@gmail.com>
Co-authored-by: Tim de Jager <tdejager89@gmail.com>
Co-authored-by: Tim de Jager <tdejager89@gmail.com>
docs/tutorials/rust.md
Outdated
| pixi add rust | ||
| ``` | ||
|
|
||
| This will add the `rust` package to your `pixi.toml` file. |
There was a problem hiding this comment.
also maybe we can add something like:
This will add the rust package to your pixi.toml file under [dependencies]
| ## Add a `cargo` project | ||
| As you now have rust installed, you can create a `cargo` project in your `pixi` project. | ||
| ```shell | ||
| pixi run cargo init |
There was a problem hiding this comment.
I would add here maybe as a note which will briefly explain how pixi run works so it would be clear for a novice user why we write
pixi run cargo init
docs/tutorials/rust.md
Outdated
| installing `pkg-config`. | ||
| ... | ||
| ``` | ||
| You can fix this with pixi: |
There was a problem hiding this comment.
maybe we can write something like this:
You can fix this by adding necessary dependencies for building git2
| Compiling my_rust_project v0.1.0 (/my_rust_project) | ||
| Finished dev [unoptimized + debuginfo] target(s) in 7.44s | ||
| Running `target/debug/my_rust_project` | ||
| ``` |
There was a problem hiding this comment.
Maybe we can write a small outro? like conclusion or some small push for user to discover other commands
something like:
As a small exercise you can add clippy as dependency
add cargo fmt as a task.
Also another crazy idea and you can totally ignore it:
maybe we can add a call to action for our users to share completion of this tutorial on twitter / linkedin?
something like:
You can share a completion of this tutorial within our amazing community! Post it on linkedin or twitter with #pixi #prefix.dev and share your thoughts!
Showing how pixi can help even when an amazing tool like cargo exists