doc_markdown should ignore things which just contain acronyms

Metriche repository

Star

10.406 star (10.406 star)

Metriche merge PR

Merge medio 19g 22h (Merge medio 19g 22h)113 PR mergiate in 30 g (113 PR mergiate in 30 g)

Descrizione

Guida contributor

Direzione di ricerca

Il problema richiede di modificare il lint doc markdown in clippy per ignorare le stringhe che sono acronimi (ad esempio DirectX, OpenGL). La logica dovrebbe trattare tali stringhe come non richiedenti backtick. L'implementazione dovrebbe essere nel codice del lint, probabilmente in `clippy lints/src/doc.rs`. C'è un commento che suggerisce di verificare se una parola è tutta in maiuscolo con una singola lettera minuscola alla fine? In realtà il problema dice che per il camel case dovrebbe avere almeno due parole in camel case ciascuna con almeno una lettera minuscola. Quindi la correzione consiste nell'adeguare il rilevamento del camel case per escludere stringhe che sono solo acronimi (tutte maiuscole o con una minuscola finale?). Il contributore dovrebbe esplorare l'implementazione esistente di doc markdown e aggiungere una condizione per saltare parole che consistono solo di lettere maiuscole o hanno una singola lettera minuscola finale (come DirectX). Fare riferimento ai test esistenti in `tests/ui/doc.rs`.

Tech stack

rust

Dominio

developer experiencetooling

Tipo issue

Funzionalità

DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.

3

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.

Abbastanza chiara

Prerequisiti

RustGit

Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.

70