whatisgithub

What is techguide?

alura/techguide — explained in plain English

Analysis updated 2026-06-26

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

In one sentence

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

What do people build with it?

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

What is it built with?

HTMLYAMLJavaScript

How does it compare?

alura/techguidephodal/ideabookxovee/uestc-course
Stars3,7663,7623,755
LanguageHTMLHTMLHTML
Setup difficultyeasyeasyeasy
Complexity1/51/51/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get 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.

So what is it?

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.

Frequently asked questions

What is techguide?

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.

What language is techguide written in?

Mainly HTML. The stack also includes HTML, YAML, JavaScript.

What license does techguide use?

Use, modify, and distribute freely for any purpose including commercial use, as long as you keep the MIT license notice.

How hard is techguide to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is techguide for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.