crate-ci / azure-pipelines

Easy continuous integration for Rust projects with Azure Pipelines
MIT License
88 stars 24 forks source link

Add example to publish crate documentation using Azure pipeline #69

Closed shuwens closed 4 years ago

shuwens commented 4 years ago

I have tried to use Azure pipeline but it didn't work.

epage commented 4 years ago

I'm curious, what is your use case for publishing documentation outside of what docs.rs provides?

shuwens commented 4 years ago

@epage Yeah, my situation is a bit weird. I am working on a research prototype (NetBricks) that it is no longer maintained. I don't think I should publish the project on doc.rs since I am not the owner of it.

epage commented 4 years ago

Interesting. The sad thing is we are becoming so reliant on docs.rs, as a community, that efforts to help publish documentation on our own have been disappearing. For example, support for it in cargo-release was deprecated and then removed. Because of that, I'm also a bit unsure of the value of us maintaining documentation for the proces.

shuwens commented 4 years ago

@epage I have found out that the wasm-bindgen still uses azure pipeline for generating docs. One other use case could be that the developers want to host a separate doc page which enables documentation for private fields etc.

shuwens commented 4 years ago

Closed, other people can take a look at rust-azure-pipelines