docs.rs hangs on this crate

[matthew-a-thomas]

Docs.rs hasn't updated their documentation for ~15 hours now. Looks like this crate is clogging up their pipeline.

Recent crates (notice the ~15 hours):

Queue showing this crate at the top:

Queue length as of this writing:

I'm running cargo doc --features stm32f303,rt to see how long it takes locally. Will update here when it finishes (it's been about five minutes so far).

Is there something that can be done in this crate to ease the load on docs.rs?

[matthew-a-thomas]

Well, that was anti-climactic. Shortly after I wrote the above my local docs run finished. Less than six minutes.

So now I'm not sure? I accused this crate because of rust-lang/docs.rs#335 and the similarity of stm32X and also because of the docs.rs queue as pictured above.

cargo doc --features stm32f303,rt
  Downloaded cortex-m-rt v0.6.9
  Downloaded r0 v0.2.2
  Downloaded cortex-m-rt-macros v0.1.5
  Downloaded quote v0.6.13
  Downloaded rand v0.5.6
   Compiling proc-macro2 v0.4.30
   Compiling unicode-xid v0.1.0
 Documenting unicode-xid v0.1.0
 Documenting rand_core v0.4.0
   Compiling rand_core v0.4.0
   Compiling syn v0.15.39
   Compiling cortex-m-rt v0.6.9
    Checking r0 v0.2.2
   Compiling stm32f3 v0.7.1
 Documenting r0 v0.2.2
    Checking rand_core v0.3.1
    Checking rand v0.5.6
 Documenting rand_core v0.3.1
 Documenting proc-macro2 v0.4.30
    Checking quote v0.6.13
 Documenting rand v0.5.6
 Documenting quote v0.6.13
 Documenting syn v0.15.39
 Documenting cortex-m-rt-macros v0.1.5
   Compiling cortex-m-rt-macros v0.1.5
 Documenting cortex-m-rt v0.6.9
 Documenting stm32f3 v0.7.1
 Documenting alt-stm32f30x-hal v0.22.1-alpha.0
    Finished dev [unoptimized + debuginfo] target(s) in 5m 42s

[matthew-a-thomas]

It was definitely this crate. Docs.rs has caught back up now, but apparently only by canceling this crate's two jobs? Here's what I see now a few pages into https://docs.rs/releases:

Notice how all the other crates in the OP screenshots are shown here except this crate. Also notice how this crate isn't listed in https://docs.rs/releases/recent-failures

[little-arhat]

stm32f3 does quite a lot code generation, and this crates has some macros, but I will be surprised if they are the most complicated out of all crates published to docs.rs. What versions of cargo/rust are used in docs.rs? Can it be regression there? There were no significant changes in this crate for a while.

[little-arhat]

Finished dev [unoptimized + debuginfo] target(s) in 4m 53s
cargo doc --features stm32f303,rt  366.65s user 23.45s system 132% cpu 4:53.48 total

[matthew-a-thomas]

@little-arhat Unfortunately I'm unable to help too much with this. I'm not connected to docs.rs in any way except I noticed my own crate's documentation was taking a long time to show up there, hence this issue.

Yeah it is strange though that it works fine locally.

Might be worth reaching out to some of the people on the following thread? rust-lang/docs.rs#335

[little-arhat]

@matthew-a-thomas ah, clear. Thanks for bringing this up!