Skip to content

Commit

Permalink
Credit where credit is due
Browse files Browse the repository at this point in the history
  • Loading branch information
sambsnyd committed Oct 24, 2024
1 parent 7c65044 commit 54b5287
Showing 1 changed file with 4 additions and 0 deletions.
4 changes: 4 additions & 0 deletions docs/authoring-recipes/refaster-recipes.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ import TabItem from '@theme/TabItem';

# Getting started with Refaster template recipes

[Refaster](https://errorprone.info/docs/refaster) is an open source refactoring technology unaffiliated with OpenRewrite, originally presented to the world by [Louis Wasserman in his 2013 paper](https://dl.acm.org/doi/10.1145/2541348.2541355).
Refaster is easy to use and understand even for developers with no prior experience with parsers, compilers, or other refactoring tools.
OpenRewrite has independently implemented support for Refaster-style templates so that recipe authors can benefit from Refaster's accessibility and existing catalogue of useful refactoring operations.

Refaster template recipes are recipes created from [Refaster templates](#terminology) that refactor code by doing straightforward replacements (e.g., converting `StringUtils.equals(..)` to `Objects.equals(..)`). These are more than just a string replacement, though; they offer compiler and type support. They can also be used to build more complex recipes. Please note, though, that Refaster recipes are **whitespace agnostic** – meaning that you can't use a Refaster recipe to add or remove whitespace.

Let's walk through everything you need to know to get started making your own.
Expand Down

0 comments on commit 54b5287

Please sign in to comment.