Add a note about the design change of RFC 2906 in implementation

[messense]

rust-lang/cargo#10564 changed the metadata inheritance source from workspace to workspace.package

Rendered

[ehuss]

Thanks for the PR! I'm reluctant to merge this because we generally do not update RFCs to incorporate changes that happen afterwards. They exist as a snapshot in time of the decision that was made when the RFC was merged. There were several other changes to the RFC that this doesn't cover, and I don't want to start an impression that the RFC is being kept up-to-date, or that it is the resource people should be using for learning about a feature. If the documentation doesn't contain enough information, then I think that we should try to address that.

I do recognize that discovery of the documentation may not be great. In the future, I'll try to update tracking issues with more details after stabilization.

For this RFC, I think it would be reasonable to just put a note towards the top directing users to the stabilized documentation. Perhaps something like:

Note: This feature was stabilized in Rust 1.64. Several design changes were made in the course of the implementation. Please see the documentation for [workspace.package] and [workspace.dependencies] for details on how to use this feature.

We're discussing perhaps making a more formal way of linking something like the stabilized documentation (such as a new header at the top), but that may take a while to finalize.

[messense]

@ehuss Changed to a note, thanks for the review!

[ehuss]

Thanks!