Add post about stabilizing intra-doc links #689
Conversation
|
I'm hoping to hold off until we know when intra doc is going to stabilize |
|
cc @QuietMisdreavus if you wanna take a look |
|
Should we mention somewhere that the feature has been auto enabled on nightly and thus on docs.rs somewhere? (And that this blog post is a way to signal "you really should start using this now") |
|
@Manishearth Oh that's a good point. I think we should definitely mention it. |
I'm not really comfortable encouraging people to use unstable features ... In general it makes me uncomfortable that all docs are built with nightly by default, but I'm not sure how docs.rs can change that without breaking the entire ecosystem of docs. |
|
@jyn514 no, you misunderstand, we're encouraging them to use it more now that it is stable. |
|
Oh I see, we're saying to skip the 12-week delay until it hits stable 😆 I guess that works, I'll add that. |
|
@jyn514 no no! The reason I want that in is that some people will be confused as to why we're talking about a feature that has been around forever. This clarifies what has changed, and the important thing is that now we strongly recommend people use it. It's not about the 12 week period, in fact we should probably publish this after the feature hits beta. |
|
I pushed a change but I'm not super confident in the wording ... maybe you should write this bit :P |
|
Might it be better to post this on the main Rust blog so that more people see it? |
Co-authored-by: Camelid <37223377+camelid@users.noreply.github.com>
|
Not sure after last time ... @pietroalbini what do you think about posting this on the main blog instead of inside-rust? |
|
I'm okay with either, personally. Inside rust doesn't really require approval, but for the main blog the core team should consider this important enough. Idk if they will. |
|
This seems more like a "behind the scenes" post on the history of the feature and the challenges implementing it, rather than an announcement of what the feature is and when it will be stabilized. I personally think that's content better suited for Inside Rust, but I'm happy to raise the question to the rest of the Core Team if you so wish. |
|
I agree with that, let's keep it on inside-rust. |
|
Seems good. The only reason it might work on the main blog is because it is an interesting journey, but that's not necessarily the right bar. |
|
This week in rust just posted about the stabilization PR, so I think we should publish this today. |
cc @Manishearth
I set the date as tomorrow, but I don't have strong opinions about when to publish.