Intro
Welcome to Aliz Dev Hub, the comprehensive resource for cloud engineers and developers building on Google Cloud Platform. Whether you're architecting infrastructure, building data pipelines, developing applications, or crafting web experiences, you'll find the knowledge and best practices you need here. Learn from curated guides, explore proven patterns, and tap into the collective expertise of the Aliz engineering community. Discover how to build scalable, secure, and efficient cloud solutions.
Topics you'll find here
- Dashboards — Aliz internal dashboards and their access details
- Engineering Standards — How we build at Aliz: the engineering backlog and task-management guidelines
- Infrastructure — Cloud infrastructure design, deployment, and operations
- Data — Data platforms, pipelines, analytics, and database solutions
- Application Development — Backend and full-stack app development
- Web — Web platform development and frontend best practices
- Solution Block Hub — Discover, index, and reuse code across the organization
- AI Telemetry — How we collect AI coding-assistant usage, what's collected, and the data flow
- Tech Updates — A weekly digest of what changed across AI/ML, Infrastructure, Data, AppDev, and General Google Cloud
- Changelog — Track changes to the documentation
What you won't find here
The goal here is not to document everything about Google Cloud or software engineering. Google Cloud has comprehensive official documentation, and the web is full of tutorials. What we curate here are the patterns, decisions, and practices that matter at Aliz — the knowledge that helps our teams ship better projects faster.
Think of this as the engineering handbook: opinionated guidance on what works, what doesn't, and why we build things the way we do.
Contributing
Checkout the aliz-dev-hub GitHub repository.
Edit the existing Markdown files or add new ones inside the ./dev-hub-website/docs, then send a Pull Request.
All documentation is written in Markdown with MDX support, so you can include interactive components when needed. Follow the existing structure and conventions — check similar pages for style and formatting patterns.
Why not use X?
Aliz Wiki
The Wiki is great for project-specific documentation and team notes, but it's not ideal for knowledge that should be shared across all engineering teams. The Dev Hub uses version control, accepts contributions through pull requests, and makes it easy to keep documentation in sync with code.
Confluence
Confluence is powerful for collaboration, but it tends to accumulate outdated pages that are hard to maintain. Documentation here lives alongside code, uses familiar tools (Git, Markdown, code review), and benefits from the same engineering discipline we apply to our projects.