Skip to content

define freshness tiers for F# #48008

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

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.

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.

1 participant