http://docs.piston.rs/conrod/conrod/ Is broken

[JGHFunRun]

I'm trying to learn Conrod, and I though I would vist http://docs.piston.rs/ to find some examples. When I clicked to top link that said Conrod, it gave 404.

[bvssvni]

We are using https://docs.rs/conrod/0.61.1/conrod/ now. Where did you find the broken link?

[shanehandley]

See also: #1306

[JGHFunRun]

@bvssvni That would explain it. I think it's fixed now.

[malaire]

Most links at https://crates.io/crates/conrod are 404, for example "The Guide", "What is Conrod?", etc.

[sbrl]

Nope, it is not fixed. I have just run into this when I clicked the "Documentation" link on crates.io in a last-ditch attempt to find an actually useful tutorial (it seems that the next chapter of the tutorial which need to read isn't written yet :-/).

To be honest, I'd love to use conrod - but as a programmer who's new to Rust (but experienced in other languages), the raw documentation isn't of any particular use to me.

Without an effective tutorial, the "easy to use" in the description is rather misleading.

[alberdingk-thijm]

Per the build logs here, this is caused by the xcb crate, which I'm guessing was pulled in for the new TextBox copy-paste functionality in 0.68. xcb has a few dependencies that are probably not installed on docs.rs.

EDIT: Looks like copypasta depends on x11-clipboard, which depends on xcb. It actually looks like this was discussed in the PR #1308.

My package conrod_prompt (see #1299) is also not building due to the same issue. I was able to resolve this for a separate project at least on GitLab by adding a few prerequisites:

before_script:   
    - apt-get update -yqq
    - apt-get install -yqq libxcb-shape0-dev libxcb-xfixes0-dev
  
script:
     - rustc --version && cargo --version  
    - cargo test --all --verbose

[alberdingk-thijm]

Related: rust-lang/docs.rs#471 (comment)

[alberdingk-thijm]

copypasta has now been bumped to 0.6.1, so all existing dependencies no longer rely on xcb 0.8.2. The docs should work on the next docs.rs build.

[alvinhochun]

I believe this is now irrelevant.