Generate and publish docs, or fix docs.rs

[nikomatsakis]

docs.rs seems to encounter an error building our docs:

https://docs.rs/crate/duchess/latest

we should figure out why and fix it. We can also build docs in our CI and publish them together with the book, which may make sense.

[fpoli]

The reason is that the published 0.1.1 package of duchess does not contain the .cargo/config that initializes the CLASSPATH variable that is needed to compile the examples. I checked this even by downloading the source code with cargo download duchess=0.1.1.

Running cargo package in my duchess repo generates a target/package/duchess-0.1.1 folder that contains a copy of .cargo, as expected. Could you check if that's the same in your system?

[fpoli]

I gave a quick look at the log of the failed docs.rs run for 0.1.5 and the reason is still the same: the .cargo/config file is missing.

[rcoh]

current failing build log:
https://docs.rs/crate/duchess/0.1.8/builds/1159671

[INFO] running `Command { std: "docker" "start" "-a" "f398fc85010b024af20a662633027c7746b250db887fba079f2366ecd4b4f461", kill_on_drop: false }`
[INFO] [stderr] warning: target filter specified, but no targets matched; this is a no-op
[INFO] [stderr]  Documenting duchess v0.1.8 (/opt/rustwide/workdir)
[INFO] [stderr] error: failed to execute `"javap" "-p" "java.lang.Class"`: No such file or directory (os error 2)
[INFO] [stderr]   --> src/java.rs:67:9
[INFO] [stderr]    |
[INFO] [stderr] 67 | /         public final class java.lang.Class {
[INFO] [stderr] 68 | |             public java.lang.String toString();
[INFO] [stderr] 69 | |             public java.lang.String toGenericString();
[INFO] [stderr] 70 | |             public native boolean isInstance(java.lang.Object);
[INFO] [stderr] ...  |
[INFO] [stderr] 82 | |             public java.lang.Class arrayType();
[INFO] [stderr] 83 | |         }