Listas de tarefas

As Task Lists (listas de tarefas) são uma extensão do GitHub Flavored Markdown para criar checklists, muito úteis em gestão de projetos e acompanhamento de tarefas.

Sintaxe básica

Tarefas por fazer

Cria itens não concluídos com - [ ]:

- [ ] Concluir documentação do projeto
- [ ] Escrever testes unitários
- [ ] Fazer deploy em produção

Resultado:

• [ ] Concluir documentação do projeto
• [ ] Escrever testes unitários
• [ ] Fazer deploy em produção

Tarefas concluídas

Usa - [x] ou - [X] para itens concluídos:

- [x] Criar esqueleto do projeto
- [X] Desenhar estrutura da base de dados
- [x] Implementar autenticação

Resultado:

• [x] Criar esqueleto do projeto
• [X] Desenhar estrutura da base de dados
• [x] Implementar autenticação

Lista mista

## Progresso do desenvolvimento

- [x] Análise de requisitos
- [x] Escolha de tecnologia
- [ ] Frontend
  - [x] Página de login
  - [x] Página principal
  - [ ] Página de perfil
- [ ] Backend
  - [x] API de utilizadores
  - [ ] API de pedidos
  - [ ] Integração de pagamentos
- [ ] Testes
  - [ ] Unitários
  - [ ] Integração
- [ ] Deploy

Resultado:

Progresso do desenvolvimento

• [x] Análise de requisitos
• [x] Escolha de tecnologia
• [ ] Frontend
  • [x] Página de login
  • [x] Página principal
  • [ ] Página de perfil
• [ ] Backend
  • [x] API de utilizadores
  • [ ] API de pedidos
  • [ ] Integração de pagamentos
• [ ] Testes
  • [ ] Unitários
  • [ ] Integração
• [ ] Deploy

Regras de formatação

Requisitos de sintaxe

Elemento	Sintaxe	Notas
Marcador	-	Usar hífen
Espaço		Hífen seguido de espaço
Caixa	[ ]	Espaço dentro: por fazer
Feito	[x]/[X]	Marca concluído
Texto	livre	Espaço após a caixa

Formato correto

✅ Correto:
- [ ] Tarefa 1
- [x] Tarefa 2
- [X] Tarefa 3

❌ Incorreto:
-[ ] Falta espaço
- [] Caixa inválida
- [o] Marca inválida
* [ ] Marcador errado

Aninhamento

Vários níveis

- [ ] 📋 Planeamento de produto
  - [x] Pesquisa de mercado
  - [x] Análise de concorrentes
  - [ ] Entrevistas com utilizadores
    - [x] Preparar perguntas
    - [ ] Contactar participantes
    - [ ] Conduzir entrevistas
    - [ ] Compilar resultados
  - [ ] Documento de requisitos

- [ ] 🎨 UI/UX
  - [ ] Protótipos
    - [x] Baixa fidelidade
    - [ ] Alta fidelidade
  - [ ] Design visual
    - [ ] Paleta de cores
    - [ ] Ícones
    - [ ] Layouts

- [ ] 💻 Desenvolvimento
  - [x] Arquitetura técnica
  - [ ] Frontend
  - [ ] Backend
  - [ ] Base de dados

Resultado:

• [ ] 📋 Planeamento de produto

  • [x] Pesquisa de mercado
  • [x] Análise de concorrentes
  • [ ] Entrevistas com utilizadores
    • [x] Preparar perguntas
    • [ ] Contactar participantes
    • [ ] Conduzir entrevistas
    • [ ] Compilar resultados
  • [ ] Documento de requisitos

• [ ] 🎨 UI/UX

  • [ ] Protótipos
    • [x] Baixa fidelidade
    • [ ] Alta fidelidade
  • [ ] Design visual
    • [ ] Paleta de cores
    • [ ] Ícones
    • [ ] Layouts

• [ ] 💻 Desenvolvimento

  • [x] Arquitetura técnica
  • [ ] Frontend
  • [ ] Backend
  • [ ] Base de dados

Aperfeiçoamentos

Categorias com emojis

## 📅 Plano da semana

### 🔥 Alta prioridade
- [x] 🐛 Corrigir bug de login
- [ ] 🚀 Lançar versão v2.1
- [ ] 📊 Fechar relatório trimestral

### 📋 Rotina
- [x] 📝 Atualizar documentação
- [ ] 🧪 Escrever testes
- [ ] 🔍 Code review

### 💡 Melhorias
- [ ] ⚡ Otimizar carregamento
- [ ] 🎨 Melhorar UI
- [ ] 📱 Adaptar mobile

Resultado:

📅 Plano da semana

🔥 Alta prioridade

• [x] 🐛 Corrigir bug de login
• [ ] 🚀 Lançar versão v2.1
• [ ] 📊 Fechar relatório trimestral

📋 Rotina

• [x] 📝 Atualizar documentação
• [ ] 🧪 Escrever testes
• [ ] 🔍 Code review

💡 Melhorias

• [ ] ⚡ Otimizar carregamento
• [ ] 🎨 Melhorar UI
• [ ] 📱 Adaptar mobile

Com detalhes

- [ ] **Registo de utilizadores** `importante`
  - Registo por e‑mail
  - Validação por telemóvel
  - SSO de terceiros
  - **Deadline**: 2023-12-15
  - **Responsável**: Zhang

- [x] **Integração de pagamentos** `feito`
  - Provider A
  - Provider B
  - Cartão
  - **Concluído em**: 2023-11-20
  - **Responsável**: Li

- [ ] **Otimização da BD** `em curso`
  - Queries
  - Reindexação
  - Limpeza
  - **Previsto**: 2023-12-10
  - **Responsável**: Wang

Resultado:

• [ ] Registo de utilizadores importante

  • Registo por e‑mail
  • Validação por telemóvel
  • SSO de terceiros
  • Deadline: 2023-12-15
  • Responsável: Zhang

• [x] Integração de pagamentos feito

  • Provider A
  • Provider B
  • Cartão
  • Concluído em: 2023-11-20
  • Responsável: Li

• [ ] Otimização da BD em curso

  • Queries
  • Reindexação
  • Limpeza
  • Previsto: 2023-12-10
  • Responsável: Wang

Casos de uso

1. Gestão de projetos

# Projeto de e‑commerce

## Sprint 1 (2023-11-01 - 2023-11-15)

### 🎯 Objetivo
Concluir sistema de utilizadores e catálogo básico

### 📋 Tarefas

#### Utilizadores 👤
- [x] Registo/Login
- [x] Verificação por e‑mail
- [x] Reset de palavra‑passe
- [ ] Perfil
- [ ] Upload de avatar

#### Produtos 🛍️
- [x] Lista de produtos
- [x] Página de detalhe
- [ ] Pesquisa
- [ ] Filtro por categorias
- [ ] Avaliações

#### Carrinho 🛒
- [ ] Adicionar ao carrinho
- [ ] Gestão de itens
- [ ] Atualizar quantidades
- [ ] Checkout

### 🐛 Correções
- [x] Estado de sessão inconsistente
- [x] Falha de carregamento de imagem
- [ ] Lento em algumas páginas
- [ ] Problemas de responsive

### 📝 Documentação
- [x] API
- [ ] Manual do utilizador
- [ ] Guia de deploy

2. Plano de estudos

# 🎓 Plano de estudo de JavaScript

## Fase 1: Fundamentos (Semanas 1‑2)

### ES6+
- [x] let/const
- [x] Arrow functions
- [x] Template strings
- [x] Destructuring
- [ ] Spread/Rest
- [ ] Promise e async/await
- [ ] Módulos (import/export)

### DOM
- [x] Seleção/manipulação
- [x] Eventos
- [ ] Criação dinâmica
- [ ] Estilos
- [ ] Formulários

## Fase 2: Avançado (Semanas 3‑4)

### FP
- [ ] Funções de alta ordem
- [ ] Funções puras/efeitos
- [ ] Composição
- [ ] Currying
- [ ] Closures

### Assíncrono
- [x] Callbacks
- [x] Promises
- [ ] Boas práticas async/await
- [ ] Tratamento de erros
- [ ] Concorrência

### Performance
- [ ] Code splitting
- [ ] Lazy loading
- [ ] Memória
- [ ] Métricas e profiling

## Notas 📚
- [x] Resumo diário
- [ ] Exemplos de código
- [ ] Questões difíceis
- [ ] Projeto prático

3. Ata de reunião

# 📅 Reunião semanal (2023-11-20)

## Agenda

### 📊 Revisão
- [x] Revisão de requisitos
- [x] Feedback de utilizadores
- [x] Relatório de concorrentes
- [x] Relatório analítico

### 🎯 Plano da semana
- [ ] Protótipo de nova funcionalidade
- [ ] Otimizações de UX
- [ ] Avaliação técnica
- [ ] Planeamento de lançamento

### 🚧 Pendências
- [ ] **Churn elevado**
  - Analisar causas
  - Definir melhorias
  - Medir impacto
  
- [ ] **Páginas lentas**
  - Pesquisa técnica
  - Proposta de otimização
  - Cronograma

### 📋 Ações
- [ ] Zhang: questionário de pesquisa (sexta)
- [ ] Li: protótipo (terça)
- [ ] Wang: avaliação técnica (quarta)
- [ ] Zhao: atualização de concorrentes (quinta)

### 📝 Decisões
- [x] Roteiro do próximo mês
- [x] Orçamento para UX
- [ ] Normas de colaboração

4. GTD pessoal

# 🗂️ Sistema pessoal de tarefas

## 📬 Inbox
- [ ] Responder e‑mails de clientes
- [ ] Organizar desktop
- [ ] Marcar dentista
- [ ] Pesquisar curso

## 🎯 MIT (tarefas mais importantes)
1. [ ] 🔥 Proposta do projeto (2h)
2. [ ] 📞 1:1 com membro da equipa (1h)
3. [ ] 📚 Ler documentação (30m)

## 📅 Plano da semana
- [ ] **Trabalho**
  - [x] Seg: kick‑off
  - [x] Ter: requisitos
  - [ ] Qua: protótipo
  - [ ] Qui: review técnica
  - [ ] Sex: retro

- [ ] **Desenvolvimento pessoal**
  - [x] Concluir cap. 3 do curso
  - [ ] Escrever post técnico
  - [ ] Palestra/meetup
  - [ ] Atualizar CV

- [ ] **Vida**
  - [x] Ginásio (2ª/4ª/6ª)
  - [ ] Jantar com amigos
  - [ ] Filme
  - [ ] Arrumar quarto

## 📚 À espera (Waiting For)
- [ ] Materiais do design
- [ ] Feedback do cliente
- [ ] Deploy do servidor

## 💡 Um dia/talvez (Someday/Maybe)
- [ ] Nova linguagem de programação
- [ ] Escrever um livro técnico
- [ ] Side project
- [ ] Viajar para o Japão

Erros comuns e soluções

1) Sintaxe incorreta

❌ Incorreto:
-[ ] Falta espaço
-[] Caixa inválida
- [o] Marca inválida
* [x] Marcador errado

✅ Correto:
- [ ] Por fazer
- [x] Concluída
- [X] Concluída (maiúscula também)

2) Aninhamento

❌ Incorreto:
- [ ] Tarefa
- [ ] Subtarefa (sem indentação)

✅ Correto:
- [ ] Tarefa
  - [ ] Subtarefa (com indentação)
  - [ ] Outra subtarefa

3) Posição da caixa

❌ Incorreto:
- Descrição [ ] (caixa no fim)

✅ Correto:
- [ ] Descrição (caixa no início)

Plataformas

GitHub/GitLab

• ✅ Caixas interativas
• ✅ Clique direto na interface
• ✅ Issues e PRs

Editores

• VS Code: suporte completo
• Typora: edição visual
• Obsidian: listas interativas
• Notion: converte para to‑dos

Geradores estáticos

• VitePress: renderiza (não interativo)
• GitBook: mostra listas
• Docsify: pode requerer plugin
• Jekyll: suporte nativo no GitHub Pages

Boas práticas

1) Clareza

✅ Recomendado: descrições curtas
- [ ] Corrigir bug de login
- [ ] Atualizar docs
- [ ] Deploy para staging

❌ Evitar: descrições longas
- [ ] Corrigir todos os problemas estranhos que alguns utilizadores...

2) Categorias e prioridade

✅ Recomendado: organizado
## 🔥 Urgente
- [ ] Corrigir bug em produção

## 📋 Rotina
- [ ] Code review
- [ ] Atualizar docs

## 💡 Ideias
- [ ] Otimizações de performance
- [ ] Nova feature

3) Atualização frequente

✅ Recomendado: manter estado
- [x] ~~Concluída~~ (pode usar tachado)
- [ ] Em curso
- [ ] Por iniciar

# Resumo semanal
- Concluídas: 3
- Pendentes: 2
- Novas: 1

Saída HTML

Conversão de Task Lists para HTML:

- [ ] Por fazer
- [x] Concluída

Converte para:

<ul>
  <li><input type="checkbox" disabled> Por fazer</li>
  <li><input type="checkbox" checked disabled> Concluída</li>
</ul>

Sintaxe relacionada

• Listas
• Sintaxe estendida
• Boas práticas

Exercícios

Cria:

1. Uma checklist para plano de estudos
2. Uma checklist por fases de um projeto
3. Uma estrutura aninhada com vários níveis
4. Uma lista com emojis e prioridades

Ferramentas

Gestão de tarefas

• GitHub Projects: suporte nativo
• Notion: gestão poderosa
• Obsidian: conhecimento e tarefas
• Todoist: app profissional

Editores Markdown

• Typora: WYSIWYG
• Mark Text: pré‑visualização
• Zettlr: foco académico
• Joplin: open‑source

Extensões

• Markdown Here: para e‑mails
• GitHub Task Lists: melhorias no GitHub
• Markdown Viewer: render local