docs for cognitive-services-speech-sdk-rs failing to build

[adambezecny]

Crate name: cognitive-services-speech-sdk-rs
Build failure link: https://docs.rs/crate/cognitive-services-speech-sdk-rs/0.1.1/builds/380044

Additional details:
failing to build because custom build script is trying to download native dependencies (MS Speech SDK) from github. I originally had these dependencies in lib directly but then I was not able to publish lib to crates.io since it allows only 10 MB in total per lib.

Please advise how to proceed to build documentation for this crate. I cannot include libs directly due to 10 MB limitation and I cannot download them due to docs.rs buildsend box limitation.

[jyn514]

You might be able to use #315 if it's ever finished. I don't have suggestions other than that.

[adambezecny]

hi, can you provide more info on this option? At a first glance I am little bit in the mist. Based on pasted link it does not seem like viable. Rustdoc is just bunch of static html files. Any chance to load these files directly into https://docs.rs/ ? I am very keen to have this doc published. Crate I have created supports official MS Speech SDK in very comprehensive way, it would be pity not to have it documented properly.

[jyn514]

I don't know what you mean by "load these files directly" - do you mean compile the docs on your own and upload them? That's #93.

I think I'd recommend hosting your own documentation on a separate website and linking to that in the readme. Docs.rs defaults to showing the readme if the documentation didn't build: https://docs.rs/deno_runtime.

[jyn514]

@adambezecny are you planning to work on this? If not there's not much point in us tracking it ... the features you've requested are already tracked elsewhere.

[adambezecny]

hi, working on what exactly? docs.rs has very sever limitations, like build cannot download any external dependencies, file system is read only. Makes very hard to build docs for crates which are using these things. I had to host documentation somewhere else. I guess this can be closed than. thx

[jyn514]

Got it. Sorry for the trouble.