The Astronomer team has learned several key lessons in building their developer documentation, including the importance of atomizing documents to make them more navigable, creating a tight feedback loop between docs and product, making it easy for all team members to contribute to docs, using tools that can mature with the docs, leveraging data to prioritize work, and investing in taxonomy over process changes.