# RFC: scotty API deprecation and cleanup policy

**URL:** <https://discourse.haskell.org/t/rfc-scotty-api-deprecation-and-cleanup-policy/8340>\
**Category:** Learn\
**Created:** [December 17, 2023, 9:16am UTC](https://discourse.haskell.org/t/rfc-scotty-api-deprecation-and-cleanup-policy/8340 "2023-12-17T09:16:21Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![ocramz](https://sea2.discourse-cdn.com/flex002/user_avatar/discourse.haskell.org/ocramz/32/3713_2.png) [@ocramz](https://discourse.haskell.org/u/ocramz)\
**Post date:** [December 17, 2023, 9:16am UTC](https://discourse.haskell.org/t/rfc-scotty-api-deprecation-and-cleanup-policy/8340/1 "2023-12-17T09:16:21Z")

</div>

> <https://github.com/scotty-web/scotty/issues/361>
>
> We are currently in a consolidation phase of the library, changing some type sig…natures and deprecating a bunch of redundant functions and instances. We should be following a consistent policy for cleaning up the namespace after a symbol has been deprecated.
> 
> E.g. :
> 
> \* version \`A.B.C\` : \`DEPRECATE\` function \`X\`
> \* version \`A.(B+3\*i)\` or \`(A+i)\`: delete \`X\` (where \`i\` is a positive integer e.g. 2) . Depends on how we interpret the \[PVP\](https://pvp.haskell.org/).

Hi! I would love some feedback and thoughts on how to evolve an established library such as scotty. Currently we are pretty careful to document all changes and not break the interface across minor versions but at some point it will be time to retire the deprecated parts.

---

<div class="post-metadata">

**Author:** ![tomjaguarpaw](https://sea2.discourse-cdn.com/flex002/user_avatar/discourse.haskell.org/tomjaguarpaw/32/1230_2.png) [@tomjaguarpaw](https://discourse.haskell.org/u/tomjaguarpaw)\
**Post date:** [December 17, 2023, 9:21am UTC](https://discourse.haskell.org/t/rfc-scotty-api-deprecation-and-cleanup-policy/8340/2 "2023-12-17T09:21:14Z")

</div>

Nice idea! Have you seen [the breakage policy](http://h2.jaguarpaw.co.uk/posts/opaleyes-api-breakage-policy/) I wrote for Opaleye?