Skip to content

Conversation

BillWagner
Copy link
Member

Define freshness tiers for different folders in the F# guide.

I followed the general strategy I used for C#: Areas that are likely to need updates for each release based on new features are 1 year. Most reference is 3 years: Someone should give it a look, even if it's not likely that new features impact it. Some of the reference for stable features is 5 years. Compiler diagnostics are 10 years.

Define freshness tiers for different folders in the F# guide.

I followed the general strategy I used for C#:  Areas that are likely to need updates for each release based on new features are 1 year. Most reference is 3 years: Someone should give it a look, even if it's not likely that new features impact it.  Some of the reference for stable features is 5 years. Compiler diagnostics are 10 years.
@BillWagner BillWagner requested a review from a team as a code owner August 19, 2025 19:04
@dotnetrepoman dotnetrepoman bot added this to the August 2025 milestone Aug 19, 2025
@dotnet-policy-service dotnet-policy-service bot added the okr-freshness OKR: Freshness of content label Aug 19, 2025
@BillWagner
Copy link
Member Author

@T-Gro Can you give this a once over. The new metadata here determines when an article gets flagged in reporting for a mandatory edit pass. The more "stable" an article is, the longer that duration can be.

For example, I doubt existing compiler diagnostics would go away, or be emitted for new reasons. Those are the longest value. Language reference is somewhat longer because of the high backwards compatibility bar we have. (Other signals tell when to update a page here for new features). Our get started and conceptual material should change more often because any feature might impact our recommendations for given scenarios.

@T-Gro
Copy link
Member

T-Gro commented Aug 25, 2025

Hi @BillWagner , I will do a rough assessment.
Due to the high-OSS-engagement (at least compared to other parts of .NET), the volatility of moving parts can be highly unpredictable - but I will still try to do a best guess.

Co-authored-by: Tomas Grosup <tomasgrosup@microsoft.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
okr-freshness OKR: Freshness of content
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants