The main weakness of frameworks is their steep learning curve. So, improving their documentation is a critical issue. This paper presents a Case-Based Reasoning approach that complements existing documentation methods and faces their main drawbacks. The main contributions of our work are:--The development of an approximate retrieval mechanism to locate the most similar framework usage experience (case) for a query posed by the user. That way, we cope with the typical sequential searches in cookbooks, very inefficient in a real context.--The development of an interactive adaptation mechanism that guides the user in obtaining new usage experiences. Thus, we face the fact that it results unrealistic to try to represent every use of the framework.--The existence of a learning mechanism that lets the user to enrich the case base with new experiences, what reduces the initial effort of the usage experience acquisition.Our approach is illustrated by OoFRA, a prototype tool that provides intelligent documentation for a framework in the graphical user interface domain.