API Improvement Proposals

<!DOCTYPE html> <html lang="en-US" class="glue-flexbox"> <head> <title>API Improvement Proposals</title> <meta charset='utf-8'> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width,maximum-scale=2"> <link href="//fonts.googleapis.com/css?family=Roboto:100,300,400,500,700|Google+Sans:400,500|Product+Sans:400&lang=en" rel="stylesheet"></link> <link rel="shortcut icon" href="/assets/favicon.ico"> <link rel="stylesheet" type="text/css" media="screen" href="//www.gstatic.com/glue/v22_1/glue.min.css"> <link rel="stylesheet" type="text/css" media="screen" href="/assets/css/style.css?v=26220397"> <link rel="stylesheet" type="text/css" media="screen" href="/assets/css/hero.css?v=26220397"> <link rel="stylesheet" type="text/css" media="print" href="/assets/css/print.css?v=26220397"> <script type="text/javascript" src="//code.jquery.com/jquery-3.4.0.min.js"></script> <script type="text/javascript" src="//www.gstatic.com/glue/latest/glue-detect.min.js"></script> <script type="text/javascript"> $('html').css('visibility', 'hidden'); $.when($.ready).then(() => { $('html').css('visibility', 'visible'); }); </script> <script type="text/javascript" src="/assets/js/global.js?v=26220397"></script> <script async src="https://www.googletagmanager.com/gtag/js?id=UA-140054909-1"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'UA-140054909-1'); </script> </head> <body>  <header class="glue-header glue-header--single"> <div class="glue-header__bar glue-header__bar--desktop glue-header__drawer"> <div class="glue-header__tier">  <div class="glue-header__container"> <div class="glue-header__lock-up"> <div class="glue-header__logo"> <a class="glue-header__logo-link" href="/" title="Google"> <div class="glue-header__logo-container"> <svg role="img" aria-hidden="true" class="glue-header__logo-svg"> <use xlink:href="/assets/images/glue-icons.svg#google-color-logo"></use> </svg> </div> <p class="glue-header__logo--product">AIPs</p> </a> </div> <a href="#page-content" class="glue-header__skip-content"> <p class="glue-header__skip-content-text">Jump to Content</p> </a> </div> </div>  <div class="glue-header__container glue-header__container--flex-auto"> <nav class="glue-header__link-bar"> <ul id="list-1" class="glue-header__list"> <li class="glue-header__item"> <a class="glue-header__link" href="/general" aria-level="1">Browse AIPs</a> </li> <li class="glue-header__item"> <a class="glue-header__link" href="/news" aria-level="1">News</a> </li> <li class="glue-header__item"> <a class="glue-header__link" href="/faq" aria-level="1">FAQ</a> </li> <li class="glue-header__item"> <a class="glue-header__link" href="/contributing" aria-level="1">Contributing</a> </li> <li class="glue-header__item"> <a class="glue-header__link" href="https://linter.aip.dev/" target="_blank" aria-level="1"> API Linter <svg role="img" class="glue-icon glue-icon--18px"> <use xlink:href="/assets/images/glue-icons.svg#open-in-new"></use> </svg> </a> </li> </ul> </nav> </div>  <div class="glue-header__container glue-header__container--cta"> <div class="glue-header__cta"> <div class="glue-sitesearch"> <form method="GET" action="/search"> <label for="q">Search this site</label> <input class="glue-sitesearch__input" type="text" name="q" id="q" placeholder="Search AIPs"> <button type="submit" class="glue-button glue-sitesearch__submit" title="Submit"> <svg role="img" class="glue-icon glue-icon--24px"> <use xlink:href="/assets/images/glue-icons.svg#search"></use> </svg> </button> </form> </div> <a href="https://github.com/aip-dev/google.aip.dev" target="_blank" class="glue-button glue-button--high-emphasis"> <img src="/assets/images/github.png" class="github-logo"> View on GitHub </a> </div> </div> </div> </div>  <div class="glue-header__bar glue-header__bar--mobile"> <div class="glue-header__tier">  <div class="glue-header__container"> <div class="glue-header__lock-up"> <div class="glue-header__hamburger glue-header__hamburger--first-tier"> <div class="glue-header__hamburger-wrapper"> <button type="button" class="glue-header__drawer-toggle-btn" aria-controls="drawer" aria-expanded="false" aria-label="Open the navigation drawer"> <svg role="img" class="glue-icon glue-icon--24px"><use xlink:href="/assets/images/glue-icons.svg#menu"></use></svg> </button> </div> </div> <div class="glue-header__logo"> <a class="glue-header__logo-link" href="/" title="Google"> <div class="glue-header__logo-container"> <svg role="img" aria-hidden="true" class="glue-header__logo-svg"> <use xlink:href="/assets/images/glue-icons.svg#google-color-logo"></use> </svg> </div> <p class="glue-header__logo--product">AIPs</p> </a> </div>  <a href="#page-content" class="glue-header__skip-content"> <p class="glue-header__skip-content-text">Jump to Content</p> </a> </div> </div>  <div class="glue-header__container"> <div class="glue-header__cta"> <a href="https://github.com/aip-dev/google.aip.dev" class="glue-button glue-button--high-emphasis"> <img src="/assets/images/github.png" class="github-logo"> View on GitHub </a> </div> </div> </div> </div> <div class="glue-header__drawer-backdrop"></div> </header> <div class="glue-page"> <main role="main" class="aip-hero" id="page-content"> <div class="aip-hero-banner"> <div class="aip-hero-title"> API Improvement Proposals </div> <div class="aip-hero-subtitle"> Focused design documents for flexible API development. </div> <div class="aip-buttons"> <a href="/general" class="glue-button glue-button--high-emphasis"> Explore the AIPs </a> <a href="/1" class="glue-button glue-button--high-emphasis"> Learn how it works </a> </div> </div> <div class="aip-landing-content"> <h1>Welcome</h1> <p> AIPs are design documents that summarize Google's API design decisions. They also provide a framework and system for others to document their own API design rules and practices. </p> </div> <div class="aip-shortcuts glue-grid glue-grid__col--align-middle"> <div class="aip-shortcut glue-grid__col glue-grid__col--span-6"> <h1>Curious about the basics?</h1> <div>AIPs are a combination of design guidance and a system we use to manage and track that guidance. Learn more about how the AIP program works in the first AIP! </div> <a href="/1" class="glue-button glue-button--medium-emphasis"> Read AIP-1 » </a> </div> <div class="aip-shortcut glue-grid__col glue-grid__col--span-6"> <h1>Want to help?</h1> <div>Interested in helping with AIPs? Contribute by proposing new guidance, commenting on existing AIPs, or fixing typos. All contributions are welcome! </div> <a href="/contributing" class="glue-button glue-button--medium-emphasis"> Contribute to the project » </a> </div> <div class="aip-shortcut glue-grid__col glue-grid__col--span-6"> <h1>Want to use AIPs for your organization?</h1> <div>AIPs are designed to be useful outside of Google. Take a look at how you might choose which AIPs are best suited to your API design needs. </div> <a href="/adopting" class="glue-button glue-button--medium-emphasis"> Learn more » </a> </div> <div class="aip-shortcut glue-grid__col glue-grid__col--span-6"> <h1>Still have questions?</h1> <div>Free free to take a look at the <a href="/faq">frequently asked questions</a>. If you don't find an answer there, file an issue on our GitHub repository. </div> <a href="https://github.com/aip-dev/google.aip.dev/issues" class="glue-button glue-button--medium-emphasis"> Ask us on GitHub » </a> </div> </div> <footer> Except as otherwise noted, the content of this page is licensed under the <a href="https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 License</a>, and code samples are licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a>. <span class="no-print">For details, see <a href="/licensing">content licensing</a>.</span> </footer> </main> </div> <script src="//www.gstatic.com/external_hosted/hammerjs/v2_0_2/hammer.min.js"></script> <script src="//www.gstatic.com/glue/v22_1/glue-vanilla.min.js"></script> <script type="text/javascript"> const headerElement = document.querySelector('.glue-header'); if (headerElement) { new window.glue.ui.header.Header(headerElement); } </script> </body> </html>

CINXE.COM

API Improvement Proposals