October 2023 Summaries

Graphite has been conducting experiments to integrate AI into engineering workflows, focusing on enhancing the create-review-merge developer process. The potential benefits of AI include increased productivity and efficiency, but there are also challenges such as the risk of bugs and poorly architected code. The company established guiding principles emphasizing visibility into AI-generated content and prioritizing code analysis over generation. Promising experiments included automated generation of Pull Request (PR) descriptions, which improved commit message quality, and weekly digest notifications summarizing codebase changes, enhancing team communication. Inline comment translation to code suggestions and AI-assisted codebase Q&A for onboarding were also successful, streamlining reviews and knowledge transfer. AI reviews provided a rapid "second pair of eyes," reducing review cycles, while other experiments like fully generative documentation and regex lint rules faced issues with accuracy and trust. The company emphasizes the importance of non-disruptive, opt-in features and maintaining a balance between false positives and negatives. Graphite is committed to carefully integrating AI into workflows, seeking feedback to refine these innovations further.

Graphite advocates for migrating from Create React App (CRA) to Next.js for developing scalable and high-performance web applications, citing significant advantages such as improved performance, SEO benefits, and enhanced developer experience. Despite initial challenges with their large, TypeScript monorepo, Graphite successfully condensed their migration process into five simple pull requests with guidance from the Vercel team and the use of Next.js's App Router. Key differences between Next.js and CRA include Next.js's support for multiple rendering strategies and its file-system-based routing, which contrasts with CRA's entirely client-side rendering and reliance on external libraries for routing. The migration process involved tackling API differences, implementing SVG imports, refactoring their folder structure, integrating Next.js by configuring necessary files and adapting routing, and handling server-side rendering complexities. Through these steps, Graphite was able to leverage Next.js's bundle-splitting, performance optimizations, and strong ecosystem, positioning it as a forward-looking choice for modern web development.

Graphite has introduced several new features to enhance user experience, including an improved PR search accessible via [CMD + K], participation in the Graphite CLI beta for early access to features, and the introduction of large emojis to add emphasis in comments. The platform now supports commit signing by syncing with GitHub to verify GPG, SSH, or S/MIME signatures, ensuring the authenticity of commits. These updates are a result of community feedback from their Slack users, who are encouraged to suggest new features. Additionally, Graphite is gaining attention through speaking engagements at events like the Next.js Conf and external contributions, such as a blog by Gergely Orosz discussing the concept of Stacked Diffs, as well as a case study highlighting its adoption as the preferred code review tool for engineers at Tecton.