Aggiornamenti, ricerca e feed: cosa cambia sul sito

Cosa cambia

Da oggi il sito ha una sezione Aggiornamenti (questa che stai leggendo): una serie di post per raccontare novità sul sito, sulla documentazione e sulla community, senza dover infilare tutto nelle pagine di riferimento esistenti.

Insieme alla sezione Aggiornamenti arrivano tre cose:

• Un feed Atom, su /feed.xml. Se usi un lettore RSS/Atom puoi iscriverti lì e sapere quando esce un nuovo post, senza dover controllare il sito a mano. Ogni voce del feed contiene titolo, data di pubblicazione e riassunto del post.
• La ricerca interna, richiamabile dal pulsante di ricerca nell'header o dalla dialog che si apre in ogni pagina del sito. Cerca nel testo delle pagine di documentazione e dei post, senza uscire dal sito o passare da un motore esterno: utile quando sai cosa cerchi ma non ricordi in quale pagina si trova.
• La documentazione raggruppata per sezione nel footer: le pagine come Guida, App, Hardware, Preset radio, Comandi, Glossario, FAQ eccetera sono ora organizzate in gruppi (Inizia, Hardware, Rete, Riferimento, Community) invece che in un elenco piatto. La barra di navigazione in testa alla pagina resta invariata: il raggruppamento riguarda solo il footer. Trovare la pagina giusta dovrebbe essere più rapido, soprattutto ora che il numero di pagine di riferimento è cresciuto.

Cosa non cambia

Nessun URL esistente è cambiato. /guida/, /hardware/, /preset-radio/, /comandi/ e tutte le altre pagine restano agli stessi indirizzi di sempre. Se hai un link salvato o condiviso da qualche parte, continua a funzionare.

Come contribuire

Il modo per contribuire resta lo stesso di sempre: ogni pagina del sito ha in fondo il link "Modifica questa pagina su GitHub", che apre l'editor GitHub sul file sorgente corretto. Al salvataggio, GitHub propone di aprire una pull request.

La novità è che, oltre alle pagine di documentazione esistenti (scritte in HTML), ora è possibile scrivere nuovi contenuti in markdown: sia nuove pagine, sia post come questo. Il markdown è più semplice da scrivere e da revisionare in una pull request rispetto all'HTML, quindi è il formato consigliato per chi vuole proporre qualcosa di nuovo.

Se vuoi scrivere un post per gli Aggiornamenti, trovi la guida pratica nel prossimo post di questa sezione.

Dove trovarci

Le discussioni sulla documentazione, sul sito e sulla rete in generale avvengono su GitHub (repository meshcore-ita) e sul gruppo Telegram pubblico MeshCore ITA, aperto a chiunque senza bisogno di invito. Se hai domande, correzioni o proposte, sono i due posti giusti dove portarle.