EmbeddingGemma 2: an open, lightweight multimodal embedding model
deepmind.google·6d ago
AI Engineering
Lobsters·21d ago·5 min read
Markdown in /src
TL;DR
Markdown is evolving into a form of source code, suggesting that it should be stored alongside generated code in the /src directory. This shift emphasizes capturing the intent behind code in a structured format that both humans and AI can understand.
✦ Why It Matters
Start integrating Markdown into your /src directory to enhance code clarity and intent capture.
Key Takeaways
- Store Markdown in /src to clarify code intent.
- Use Markdown to document architectural and design decisions.
- Ensure Markdown is human-authored for better context.
- Organize Markdown files by features, data models, and APIs.
How It Works
Markdown files are proposed to be stored in the /src directory, allowing them to serve as specifications that inform the generated code and tests. This structure promotes better organization and ensures that the rationale behind code is easily accessible.