bazelbuild/bazel

Documentation issue: "C toolchain configuration" contains extremely outdated information

Open

#13.395 aperta il 22 apr 2021

Vedi su GitHub
 (0 commenti) (7 reazioni) (0 assegnatari)Java (4465 fork)batch import
P3help wantedteam-Documentationteam-Rules-CPPtype: documentation (cleanup)

Metriche repository

Star
 (25.384 star)
Metriche merge PR
 (Merge medio 22g 20h) (77 PR mergiate in 30 g)

Descrizione

Documentation URL: https://docs.bazel.build/versions/master/cc-toolchain-config-reference.html

At the bottom:

This is a long list of features. The plan is to get rid of them once Crosstool in Starlark is done.

The linked issue was closed mid-2018. If the protobuf CROSSTOOL file is no longer supported, it would be good to remove all documentation specific to it, ideally replacing with up-to-date documentation of the current mechanism.

It'd be really really nice to have a link to a few functioning and up-to-date toolchain configs - ideally with CI tests on bazel to ensure they stay in sync with the latest bazel version.

Guida contributor

Direzione di ricerca
Identificare il meccanismo attuale per la configurazione della toolchain C/C++ in Bazel esaminando il codice sorgente del repository e la documentazione recente. Cercare esempi di configurazioni di toolchain aggiornate, preferibilmente testate in CI. Aggiornare di conseguenza la pagina di documentazione all'indirizzo https://docs.bazel.build/versions/master/cc toolchain config reference.html. Verificare se la rimozione pianificata menzionata nell'issue #5380 è stata eseguita.
Tech stack
java
Dominio
documentationbuild system
Tipo issue
Documentazione
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
2
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
Mezza giornata
Stato attivitàQuanto è probabile che la issue sia ancora attiva e reviewable.
Attiva
ChiarezzaQuanto chiaramente la issue descrive problema, scope e risultato atteso.
Chiara
Prerequisiti
Git
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
70