Vai al contenuto principale

Aggiornamento della Base di conoscenza

L'obiettivo di questa Base di conoscenze è quello di fornire a tutti le informazioni più aggiornate su tutti i tipi di argomenti relativi ad AdGuard VPN. Ma le cose cambiano costantemente e a volte un articolo non riflette più lo stato attuale: semplicemente non siamo così tanti da tenere d'occhio ogni singola informazione e aggiornarla di conseguenza quando vengono rilasciate nuove versioni.

Questo è il motivo per cui abbiamo inserito tutti i nostri contenuti KB su GitHub, e ora davvero chiunque può contribuire suggerendo modifiche e traduzioni ad articoli esistenti, così come quelli completamente nuovi.

Come suggerire una modifica o scrivere un nuovo articolo

Puoi suggerire modifiche agli articoli correnti e aggiungerne di nuovi alla Base do conoscenze, o KB, utilizzando la funzionalità di GitHub menzionata sopra. Se non hai familiarità con i principi del lavoro con la piattaforma, inizia leggendo la documentazione in questa sezione.

Quando sei pronto per iniziare, lavora nel repositorio KnowledgeBaseVPN. Tutti i testi nella nostra Base di conoscenze sono scritti in Markdown linguaggio di markup. Tienilo a mente quando modifichi o scrivi articoli. Segui questo link per saperne di più sulla sintassi di Markdown.

Il sito web della Base di conoscenza è stato creato utilizzando Docusaurus 2, un generatore moderno di siti web statici. Quando suggerisci modifiche o aggiunte, tieni presente che tutti i documenti devono essere conformi ai principi della piattaforma. Per saperne di più, consulta la guida disponibile a questo link.

È possibile distribuire questa Base di conoscenza localmente sul proprio computer per visualizzare in anteprima le modifiche suggerite. Le istruzioni dettagliate su come farlo si possono trovare nel file README.md su questa pagina di GitHub della Base di Conoscenza.

Traduzione degli articoli

La traduzione degli articoli esistenti della Base di conoscenza viene effettuata sulla piattaforma Crowdin. Tutti i dettagli sulle traduzioni e sull'utilizzo di Crowdin sono disponibili nell'articolo dedicato della Base di conoscenza di AdGuard Ad Blocker.

Quando si lavora agli articoli della Base di conoscenza di AdGuard VPN, è possibile che si incontrino stringhe contenenti forme plurali da tradurre con particolare attenzione. In a separate article, we describe in detail the difficulties that can arise when translating strings with plural forms and provide detailed guidance on how these are handled on the Crowdin platform.

Lavoro su problemi aperti

A volte appariscono attività aperte relative all'aggiornamento della Base di conoscenza. Puoi aiutarci ad accelerare il loro completamento nello stesso modo in cui suggeriresti qualsiasi altra modifica a questa Base di conoscenza. Scegli qualsiasi problema che ti interessa e inizia a lavorarci sopra. Se hai domande, puoi farle direttamente nei commenti a quel problema.