mapbox / mapbox/cpp

Running list of more terms/concepts we could document in glossary

Aperta
#36 5 commenti 1 reazione 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

glossary
Lingua principale
Nessun dato sulla lingua
Stelle
110
Fork
17
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Descrizione

The glossary is developing quickly into a pretty solid resource for the key terms you'll encounter and need to know while learning C++ at Mapbox. Or when starting to teach colleagues about how we write, deploy, and approach C++ at Mapbox.

While the glossary says explicitly that It is not intended to be a complete reference on language or syntax terms, there is much more we can do. This is a ticket to brainstorm additional concepts, terms, and keywords that are potential things to cover in the glossary and related docs.

Most of these terms don't need to be defined in the glossary, rather it would be sufficient to simply list them and links to external resources (particularly style guides we support). The overall goal is 1) note they are important to understand for C++ development a mapbox (by their presence), and 2) provide a great resource to learn more about them. We can add extra definitions where our opinions matter.

(Will be editing this in place as I collect ideas)

Key learning concepts
  • the idea of a main function in an executable
  • how to pass arguments to a C++ program and parse them - refs #35
  • const
  • const char* vs std::string and how they relate
  • pointers vs references
  • dereferencing pointers
  • taking the address of a variable
  • header guards vs #pragma once
  • learning the cpp preprocessor
  • what are templates and when to use them
  • global variables, why not to use them, when they are appropriate
  • when to use static_cast, reinterpret_cast, and const_cast. Why to use them rather than c style cases
  • how enumerations work enum in C++11. Using casts to change between them and integer types
  • the max size of numeric types. using <limits> from the stdlib to know these sizes dynamically
  • integer overflow. When it is undefined behavior, when it is defined. How to control it/prevent it. How it differs for signed types and unsigned types
  • compiler warnings. how to avoid them, fix them, appropriately suppress them. Why, when starting projects, it makes sense to use -Werror and very aggressive warnings, even -Weverything
  • how to use c++ exceptions: why to always make custom exceptions subclass std::exception. How to catch all types by catching std::exception. Why to catch exceptions by const&.
  • when to avoid throwing exceptions due to performance concerns (e.g. in tight loops)
  • what is garbage collection
  • What is reference counting
  • Why, when, and how to use std::unique_ptr vs std::shared_ptr
  • zero copy
  • Big takeaways of C++11 vs C++14 vs c++17
  • move semantics / universal references
  • considerations on when to use std::vector vs std::map vs std::list
  • binary size, why it matters, how you can learn about it (https://github.com/google/bloaty)
  • What is the _GLIBCXX_USE_CXX11_ABI flag on linux and why does it matter?
Advanced performance concepts

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Inizia da glossary.md e rivedi l’elenco esistente dei concetti C++ e delle risorse esterne proposti. La issue è più un documento aperto di brainstorming che un’attività di documentazione definita; per completarla sarebbe necessario restringere l’ambito e concordare quali termini o link aggiungere.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
cpp
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
5/5
Tempo stimato
Più di una settimana
Stato di attività
Ferma
Chiarezza
Da chiarire
Idoneità per principianti
25/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.