bazelbuild/bazel

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

Open

#13 395 ouverte le 22 avr. 2021

Voir sur GitHub
 (0 commentaires) (7 réactions) (0 assignés)Java (4 465 forks)batch import
P3help wantedteam-Documentationteam-Rules-CPPtype: documentation (cleanup)

Métriques du dépôt

Stars
 (25 384 stars)
Métriques de merge PR
 (Merge moyen 22j 20h) (77 PRs mergées en 30 j)

Description

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.

Guide contributeur

Direction de recherche
Identifier le mécanisme actuel de configuration de la chaîne d'outils C/C++ dans Bazel en examinant le code source du dépôt et la documentation récente. Rechercher des exemples de configurations de chaîne d'outils à jour, de préférence testées en CI. Mettre à jour la page de documentation à l'adresse https://docs.bazel.build/versions/master/cc toolchain config reference.html en conséquence. Vérifier si la suppression planifiée mentionnée dans l'issue #5380 a été exécutée.
Stack technique
java
Domaine
documentationbuild system
Type d'issue
Documentation
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
2
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
Une demi journée
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
Git
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
70