InfoQ Homepage Documentation Content on InfoQ
-
Rspress 2.0: AI-Native Documentation, Faster Startup and a Redesigned Theme
Rspress 2.0 has launched with a revamped theme, boosted performance, and innovative AI features, transforming developer documentation. With enhanced build speeds and a new Static Site Generation to Markdown (SSG-MD) capability, Rspress empowers developers with customizable styling options while simplifying content management. Experience superior documentation with lightning-fast efficiency!
-
Google Brings its Developer Documentation into the Age of AI Agents
Google has announced the public preview of the Developer Knowledge API. It comes with a Model Context Protocol (MCP) server. This gives AI development tools a simple, machine-readable way to reach Google's official developer documentation.
-
Meta Releases Docusaurus 3.9 with New AI Search Feature
Docusaurus 3.9 is here, enhancing documentation with AI-driven search via Algolia DocSearch v4 and modernizing runtime. It supports advanced i18n configurations, while dropping support for Node 18. With streamlined upgrades and improved multi-domain setups, this release promises robust performance for developers. Explore the latest features and improvements today!
-
AGENTS.md Emerges as Open Standard for AI Coding Agents
A new convention is emerging in the open-source ecosystem: AGENTS.md, a straightforward and open format designed to assist AI coding agents in software development. Already adopted by more than 20,000 repositories on GitHub, the format is being positioned as a companion to traditional documentation, offering machine-readable context that complements human-facing files like README.md.
-
How Docs-as-Code Helped Pinterest Improve Documentation Quality
Over the past few years, Pinterest engineers have been working to adopt Docs-as-Code across the organization. By using the same tools and processes for both code and documentation, they've improved overall documentation quality and team satisfaction. The shift also helped transform Pinterest's documentation culture, fostering collaboration, improving quality control, discoverability, and more.
-
Traefik v3.3 Release: Enhanced Observability and Documentation
TraefikLabs recently announced the latest release of Traefik Proxy v3.3 (codenamed "saint-nectaire” after a French cheese). This release focuses primarily on two critical areas: observability capabilities and improved documentation structure. These enhancements aim to make the popular open-source reverse proxy even more powerful for platform engineers working in complex cloud-native environments.
-
Cloudflare Open Sources Documentation and Adopts Astro for Better Scalability
Cloudflare recently published an article detailing their upgrade of developer documentation by migrating from Hugo to the Astro ecosystem. All Cloudflare documentation is open source on GitHub, with opportunities for community contributions.
-
JetBrains Launches IntelliJ-Based Writing Tool WriterSide
With WriterSide, JetBrains aims to allow developers and writers to create technical documentation using a write, test, build workflow. The new tool is based on IntelliJ-platform IDEs and has been used to create most of JetBrains products' documentation for the last few years.
-
AWS Shifts Strategy: Public GitHub Documentation to Be Retired
In the next few days, AWS will start retiring the AWS documentation currently available on GitHub. After reviewing the results of the project and considering the overhead of manually keeping the internal documentation in sync, the cloud provider recently decided to retire most of its public repositories.
-
Promoting Empathy and Inclusion in Technical Writing
Empathy is the first step in practicing sustainable, genuine inclusion. If persons or groups of people feel unwelcome because of the language being used in a community, its products, or documentation, then the words can be changed. Identifying divisive language can help to make changes to the words that we use.
-
Words Matter in Documentation to Build Better User Experience
The language that we use in our products or documentation can make people feel unwelcome or hurt people. We can choose words that are precise, not dependent on complex metaphors, and convey messages without negative connotations.
-
Compilation Meets Documentation: OpenJDK JEP-413
A new Java proposal offers a way to enhance API documentation through compilable source snippets.
-
Yari, the New MDN Web Documentation Platform
Mozilla Developer Network (MDN), Mozilla’s multilingual resource for web documentation, recently launched Yari, MDN Web Docs’ new platform. Yari reduces the burden of developing, maintaining, and contributing to MDN. MDN content is now stored in GitHub and can be contributed to via pull requests.
-
New MDJS Markup Language Adds JavaScript to Markdown for Interactive Documentation
Thomas Allmer, founder of Open Web Components (@OpenWc), released MDJS, a Markdown variant that allows developers to include runnable JavaScript code into their Markdown documents. MDJS can be interpreted as regular Markdown content or be progressively enhanced to produce interactive documentation including web components.
-
The Swift Method: A Framework for Software Modernization Using DDD
The Swift Method is a set of techniques for analyzing complex legacy systems, and determining the work required to gradually modernize key components or the whole system.