explaingit

alura/techguide

★ 3,766HTMLAudience · developerComplexity · 1/5LicenseSetup · easy

TLDR

A community-editable collection of learning roadmaps for tech careers, organized as YAML files and built around the T-shaped model, deep expertise in one area plus broad awareness of adjacent fields, contributed by Alura, a Brazilian tech education company.

Mindmap

mindmap
  root((TechGuide))
    What it does
      Career roadmaps
      Learning paths
      T-shaped model
    Content
      YAML cards
      Topic descriptions
      Community PRs
    Use cases
      Self-study planning
      Company training
      School curricula
    Audience
      Learners
      Educators
      Tech teams
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Find a structured learning path for a specific tech career role such as front-end developer or DevOps engineer

USE CASE 2

Contribute improvements or new topic cards to an existing career guide through a standard GitHub pull request

USE CASE 3

Generate a custom career guide for your company or school by forking the YAML structure and adding your own cards

Tech stack

HTMLYAMLJavaScript

Getting it running

Difficulty · easy Time to first run · 5min
Use, modify, and distribute freely for any purpose including commercial use, as long as you keep the MIT license notice.

In plain English

TechGuide.sh is a project from Alura, a Brazilian online technology education company, that maps out learning paths for different tech career types. The goal is to show learners and the school itself which topics, courses, and content are most relevant for a given professional role. The README is written in Portuguese. The project was inspired by roadmap.sh, a well-known open-source collection of developer learning roadmaps, but takes a different approach. Instead of a single linear path, TechGuide is organized around what the README calls the T-shaped professional model: someone who builds deep expertise in one area while also gaining working knowledge in several adjacent areas. The idea is that broader awareness of neighboring fields makes someone more effective whether working alone or on a team. Each career guide consists of a set of cards, with each card covering one topic and including a description of why that topic is worth learning. The guides live as YAML files in this repository, which means the community can contribute corrections, improvements, or new card descriptions through standard GitHub pull requests. At the time of the README, the team was focused on refining existing career guides rather than adding new ones. You can also generate a personal version of the guide using the same repository structure. The site is intended to support loading YAMLs from individuals, companies, and other schools in the future. There is a tutorial in the docs folder for creating a custom guide. The project is MIT-licensed, which means anyone can reuse or adapt it. Full English-language support is listed as a planned next step but not yet complete. The project is maintained publicly at techguide.sh.

Copy-paste prompts

Prompt 1
What topics and skills does TechGuide recommend for a back-end developer role, and in what order should I learn them?
Prompt 2
Walk me through forking TechGuide and creating a custom YAML career guide for a data analyst role at my company.
Prompt 3
How does the T-shaped model used in TechGuide differ from a linear roadmap like roadmap.sh, and which approach is better for planning my learning?
Prompt 4
Show me the YAML format for a TechGuide topic card and the pull request steps needed to add a new card to an existing guide.
Open on GitHub → Explain another repo

← alura on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.