Opportunità di contributo alla documentazione

[hugh (Hugh Lashbrooke)]

La documentazione di Discourse è il luogo principale in cui amministratori, moderatori, utenti e sysadmin possono trovare aiuto per utilizzare Discourse e gestire i propri siti.

Sebbene questa documentazione sia robusta e copra molti aspetti, ci sono alcune aree mancanti che non abbiamo ancora documentato. Questa è un’ottima opportunità per la comunità di coinvolgersi e aiutare a perfezionare questa parte importante del progetto Discourse.

Ci piacerebbe vedere più persone coinvolte nella creazione di contenuti documentali per Discourse e vogliamo rendere il più semplice possibile per chiunque farlo. A tal fine, di seguito è riportato un elenco di funzionalità o casi d’uso di Discourse che abbiamo identificato come bisognosi di nuova o migliorata documentazione.

Posizioni della documentazione

Chiunque abbia un livello di fiducia 2 o superiore può creare nuovi argomenti di documentazione in Wiki questa è la sede per tutti i contenuti della documentazione contribuiti dalla comunità. Se un argomento nella wiki della comunità è considerato rilevante o importante, può essere spostato in Documentation la sede per tutta la documentazione ufficiale di Discourse. Puoi leggere la politica sulla documentazione per maggiori dettagli a riguardo.

Badge per i contributori della documentazione

Chiunque crei un nuovo argomento nella categoria Wiki riceverà automaticamente il badge bronzo Scribe:

Se l’argomento è considerato abbastanza prezioso da essere spostato nella categoria ufficiale Documentation, qualcuno del team di Discourse lo farà manualmente, accreditando l’autore originale nel contenuto dell’argomento e assegnando loro il badge argento Ghostwriter:

Documentazione che deve essere scritta

Sebbene vogliamo in ultima analisi vedere ogni parte di Discourse completamente documentata, queste sono le aree che abbiamo identificato come aventi la necessità più pressante (gli elementi barrati indicano argomenti che sono stati scritti da quando questo post è stato pubblicato per la prima volta):

• Un tutorial generale per l’avvio per gli amministratori
• Reindirizzamenti personalizzati degli argomenti
• Spiegazione di cosa possono fare i diversi livelli utente
• Opzioni di accesso sociale
• Avvisi dei messaggi (documentazione ufficiale)
• Maggiore documentazione su come funzionano i livelli di fiducia
• Come scrivere una buona richiesta di funzionalità per Discourse (argomento wiki)
• Un riferimento su come appaiono le funzionalità markdown e di formattazione di Discourse quando incluse nelle email
• Stati utente (argomento wiki)
• Spiegazione della modalità scura, come selezionarla e come abilitare il cambio (argomento wiki)
• Documentazione generale che copre la gestione delle preferenze utente (argomento wiki)
• Documenti che spiegano come funzionano le categorie e la gerarchia in Discourse
• Una guida generale alle impostazioni degli argomenti
• Una guida generale sui plugin: cosa sono, come funzionano e come usarli
• Homepage personalizzate
• Modifica delle categorie predefinite e degli argomenti
• Utilizzo delle griglie di immagini nei messaggi (argomento wiki)
• Impostazioni di approvazione dei messaggi (argomento wiki)

Alcuni di questi potrebbero richiedere più argomenti per essere documentati in modo efficace.

Come scrivere la documentazione

Per garantire che la documentazione di Discourse sia il più efficace possibile, abbiamo una guida di stile su come scrivere questo contenuto. Sebbene sarebbe utile per tutti seguire la guida, se stai contribuendo a Wiki, non è un problema se non la segui completamente. Qualsiasi argomento spostato in Documentation verrà aggiornato dallo staff di Discourse per corrispondere alla guida di stile, se necessario.

Interessato?

Entra in Wiki e inizia a documentare oggi stesso. Se vuoi discutere di qualsiasi cosa, sentiti libero di rispondere a questo argomento per parlarne.

[Moin]

E per quanto riguarda gli argomenti esistenti? Ad esempio

@hugh

Come concedere privilegi di amministratore o moderatore agli utenti

Promoting a User to Admin or Moderator Status

This is a how-to guide intended to help existing site admins understand how to promote a user to admin or moderator status through Discourse. Required user level: Administrator Admin privileges in Discourse are powerful and allow the user to manage almost all aspects of the site. For full details on what staff users can do on a site, see Understanding user statuses, roles, and permissions. Here is a step-by-step process on how to promote a user to admin or …

@hugh

Come scrivere una buona richiesta di funzionalità per Discourse

Requesting new features for Discourse

This guide explains how to request new features for Discourse, check existing plans, and increase the chances of your feature request being prioritized. Required user level: Anyone can submit a feature request Got a great idea for a Discourse feature? That’s fantastic! Here’s how you can share it with the team effectively. Make sure your feature isn’t already made or planned Before submitting a new feature request, ensure it’s not already available or plann…

[hugh (Hugh Lashbrooke)]

Per questo:\n\n[quote="Moin, post:8, topic:326614"]\n[quote="hugh, post:1, topic:326614"]\nCome scrivere una buona richiesta di funzionalità per Discourse\n[/quote]\n\nRichiesta di nuove funzionalità per Discourse \n[/quote]\n\nLa documentazione esistente parla di come richiedere nuove funzionalità, ma non di come formattare una buona richiesta per renderla più efficace. Attualmente linkiamo a questa pagina, ma sarebbe bello se potessimo avere quel tipo di contenuto su Meta.\n\nE per questo:\n\n[quote="Moin, post:8, topic:326614"]\n[quote="hugh, post:1, topic:326614"]\nCome concedere privilegi di amministratore o moderatore agli utenti\n[/quote]\n\nConcedi privilegi di amministratore o moderatore a un utente \n[/quote]\n\nBuona osservazione! Lo rimuoverò dall’elenco in questo argomento

[ondrej]

@hugh

Come scrivere una buona richiesta di funzionalità per Discourse

C’è già questo argomento che copre le richieste di funzionalità

Requesting new features for Discourse

This guide explains how to request new features for Discourse, check existing plans, and increase the chances of your feature request being prioritized. Required user level: Anyone can submit a feature request Got a great idea for a Discourse feature? That’s fantastic! Here’s how you can share it with the team effectively. Make sure your feature isn’t already made or planned Before submitting a new feature request, ensure it’s not already available or plann…

A meno che non debba assomigliare a questo, ma per una richiesta di funzionalità?

Writing an effective bug report

This is a guide for writing effective bug reports in Discourse to maximize the chances of getting bugs fixed. Required user level: Any can report a bug Writing a good bug report is essential to help the Discourse team fix issues efficiently. This guide will walk you through the steps and best practices to ensure your bug report is clear, concise, and actionable. Summary In this documentation, we’ll cover: The importance of providing reproducible steps and…

[HamMan2118]

@hugh

Avvisi postali

Significa Avviso dello staff o qualcosa di diverso?

[ondrej]

Presumo che questo sia un avviso di post poiché è nel titolo

Post notices for first-time and returning users

To encourage kindness towards users who are posting for the first time or may not have posted in a while we’ve created a new feature that calls special attention to these new/returning users. These banners are visible to other users, but not the poster they apply to… and by default are only visible to community members who have been active enough to achieve Trust Level 2. Here’s what they look like: [image] [image] How can I configure this feature? Admins can adjust these options in their…

Gli avvisi dello staff sono fondamentalmente gli stessi, immagino?

[hugh (Hugh Lashbrooke)]

@ondrej

A meno che non debba assomigliare a questo ma per una richiesta di funzionalità?

Sì, è quello che stiamo cercando lì

@HamMan2118

@hugh

Avvisi sui post

Questo significa Avvisi dello Staff o qualcosa di diverso?

Come collegato da @ondrej, gli avvisi sui post sono quelli delineati in questo annuncio. Abbiamo quell’argomento di annuncio, ma non la documentazione effettiva al riguardo.

[Heliosurge (Dan DeMontmorency)]

Ciao Hugh, questa è un’ottima idea.

Stavo pensando di presentare un’idea per la wiki della community per avere una sorta di tag per, diciamo, i modelli di forum.

L’idea che ho per questo. Spesso abbiamo persone che chiedono di usare Discourse per cose come un Forum di Supporto, una Piattaforma di Apprendimento, ecc. Anche a volte usi più oscuri come un GDR da tavolo.

Raccogliendo contenuti da argomenti come quelli e pensando anche a vari usi. Potremmo creare una nuova risorsa con un argomento principale utilizzato come indice.

• Modelli di Forum di Supporto
• Modelli di Piattaforma di Apprendimento

Questi argomenti possono ospitare Discourse, Communique (quindi?) ecc. con plugin consigliati e componenti tematici, ecc. Oltre a un post per l’auto-ospitato.

I modelli ospitati si concentreranno sui plugin e faranno riferimento ai piani necessari per un particolare plugin da utilizzare.

Con suggerimenti e trucchi e persino indirizzando le persone al Marketplace se hanno bisogno di un layout personalizzato, di un plugin, ecc.

[NateDhaliwal]

@hugh

Stati utente

Fatto:

Custom User Statuses

Summary This document covers: What a Custom User Status Is How to add, modify, and remove a custom user status. Custom User Status Description A Custom User Status is a feature where users can set a custom status and icon to appear in their profile and next to their avatar at posts. This can be used, as a member, to let the community know if you are unavailable, on vacation, or want to share how you are feeling. A custom user status appears like this in a post: [Username "andrei" with a pal…

[hugh (Hugh Lashbrooke)]

Ho visto Fantastico vederli arrivare!

[NateDhaliwal]

Sto lavorando a quello per la modalità scura.

[NateDhaliwal]

Queste guide sono già state create ma non ancora spuntate:

@hugh

Stati utente

Custom User Statuses

Summary This document covers: What a Custom User Status Is How to add, modify, and remove a custom user status. Custom User Status Description A Custom User Status is a feature where users can set a custom status and icon to appear in their profile and next to their avatar at posts. This can be used, as a member, to let the community know if you are unavailable, on vacation, or want to share how you are feeling. A custom user status appears like this in a post: [Username "andrei" with a pal…

@hugh

Utilizzo di griglie di immagini nei post

Image Grids

This guide explains what Image Grids are and how to apply them in your posts. Required user level: Trust Level 0 Summary This document covers: Description of image grids How they can be applied in posts and how to modify them Basic Layout of image grids Image Grids Description An image grid places all of the images in your post into a neat, organized grid - rather than in a list. Below is an example of an image grid. [Delta A321-200 Landing in Washingt…

@hugh

Pagine iniziali personalizzate

Questa è un po’ confusa. Si riferisce a contenuti personalizzati della pagina iniziale? In tal caso, forse Add custom content that only appears on your homepage. Altrimenti… non è ancora stata scritta.

[hugh (Hugh Lashbrooke)]

Grazie per essere tornato qui: ho aggiornato l’OP con questi link.

@NateDhaliwal

Questo è un po’ sfocato. Si riferisce a contenuti personalizzati della homepage?

Questa è una cosa piuttosto di nicchia e si riferisce alla creazione di una homepage personalizzata, quindi non è qualcosa che la maggior parte degli amministratori di Discourse utilizzerà. Non è una funzionalità principale, poiché non è qualcosa che è completamente rifinito in questa fase.