Add docs.rs post about fewer targets #603
Conversation
|
Oh, and this time it's an |
|
I think this one should also be on the main blog. It primarily affects users of Rust and docs.rs, it’s not really about the development/developers of Rust or docs.rs. |
There was a problem hiding this comment.
Left a couple comments.
I think we should actually give a date when we will flip the switch: if we don't people are going to rush updating their crates, as they don't actually know if they can wait a couple of weeks. Instead, if a timeline is given they can plan when they want to make a change.
I'll also check in with the core team whether to post this on the main blog or not.
| ## What does this change? | ||
|
|
||
| Currently, docs.rs builds documentation for all [tier 1 platforms][platform support] by default. | ||
| After this change, docs.rs will only build one platform by default. |
There was a problem hiding this comment.
Let's specify this will build on x86_64-unknown-linux-gnu.
|
|
||
| More information on targets is available in the [platform support] page. | ||
| You can learn more about the change in [the issue proposing it][docs.rs#343] and [the PR with the implementation][docs.rs#532]. | ||
| If you want to discuss the change with the docs.rs team, feel free to join the [docs.rs discord channel]. |
There was a problem hiding this comment.
Let's also recommend opening an issue.
There was a problem hiding this comment.
I put a default title of 'Changing default targets', but people can still change it to anything if they like.
Co-authored-by: Pietro Albini <pietro@pietroalbini.org>
I don't mind giving a date, but I do say 'no earlier than July 1st' so people don't have to rush. |
|
We decided to open an RFC before actually going ahead with this change. Closing the post in the meantime. |
The 'no earlier than a month' timeline is completely arbitrary, I can make that longer or shorter. The sections are not ordered super well, I'm happy to change the order. I'd appreciate help making it less wordy,
I contacted @retep998 about mentioning
winapiexplicitlybut haven't heard back yet, we should either get confirmation that's ok or remove the mention before publishing the post.and they said that was fine, they're working on adding explicit targets now (retep998/winapi-rs#897).r? @pietroalbini