René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[Doc]: document provisional flag in API guidelines","articleBody":"### Documentation Link\n\nhttps://matplotlib.org/devdocs/devel/api_changes.html\n\n### Problem\n\nNoticed in #31162 that we don't have any guidelines for when/how to label  API as provisional, but I think it comes up in review/api discussion enough that we should at least document it. \n\n### Suggested improvement\n\nAdd a section to [API guidelines](https://github.com/matplotlib/matplotlib/pull/31162) explaining the usage of the provisional status: when to flag API as provisional, how to document provisional status, how long the status should stay provisional, etc.\n\nNOTE: This PR should probably be implemented by a maintainer because the work here is in writing up the institutional/tacit knowledge of what provisional means in the Matplotlib API context. ","author":{"url":"https://github.com/story645","@type":"Person","name":"story645"},"datePublished":"2026-07-15T14:59:44.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":2},"url":"https://github.com/32044/matplotlib/issues/32044"}