Roadmap per la versione 1.0.0

[dag7dev]

Che cos'è

Questo issue è riepilogativo e serve ad avere un quadro generale della situazione affinché il rilascio della versione 0.0.1 avvenga nel migliore dei modi.

Cose importanti da sapere e leggere

Come fare un commit in maniera efficiente: https://www.conventionalcommits.org/en/v1.0.0/#summary

Come contribuire nella repo (modus operandi)

1. Prenotarsi nella issue: scrivere nei commenti di ogni issue della quale volete occuparvi (o fatemelo semplicemente sapere) e vi assegno il task in questione. Se potete assegnarvelo da soli, va benissimo così, meglio.

2. Lavorare su un branch separato con un nome significativo (es. se il comando è /help un nome del branch potrebbe essere help-cmd)

3. A stato abbastanza maturo della funzionalità, aprire una PR sul branch main. Se avete bisogno di cambiare qualcosa, basta segnarla come draft.

Codestyle, commenti, codice

Siamo fan della pulizia e vorremmo non scrivere il codice sorgente, o ricevere tra dieci anni chiamate su "quel dì di maggio che implementammo x funzionalità".

TLDR;

Come stanno attualmente le cose

Dare un'occhiata all'attuale MozItaBot su Telegram per rendersi conto delle funzionalità e di cosa fanno i vari comandi.

I dati di mozitaantispam_bot sono gestiti tramite json : liste admin, e quant'altro sono nel file liste.json. Tutti i messaggi del bot sono salvati in frasi.json. nella cartella json del bot, incluso il testo dei bottoni. Quelle stringhe dovrebbero essere usate anziché i messaggi nel sorgente.

Se pensate sia il caso di scorporare o rinominare file, decidiamo prima di cominciare a sviluppare.

Lista in ordine di priorità

Comandi base

• /start: messaggio iniziale #2
• /help o /aiuto: messaggio con i vari bottoni #3
• /gruppi: simile a /help, bottoni con i link ai gruppi + descrizioni #4

Comandi relativi ai gruppi

Riguardano un gruppo specifico. Tipicamente strutturati come <messaggio_descrizione> + <bottone_link_gruppo> + <bottone_back>. #5

• /home
• /developers (o /sviluppo)
• /dem
• /l10n
• /news: non è un gruppo, ma fa sempre la stessa cosa. Il bottone rimanda al canale news.

Comandi di informazione generale

• /feedback: testo + due bottoni (lascia il tuo feedback e chiedi di contribuire allo sviluppo del bot) che rimandano uno in home e uno su developers #6
• /progetti: manda due messaggi. Uno con i "progetti di mozilla attivi" e una griglia da 9 bottoni in cui ci sono 9 link, nell'altro "progetti di mozillaitalia attivi" riga di 3 + 1 bottoni con link ai progetti. (trovate tutto nel json liste) #7
• /info: restituisce un messaggio di informazioni sul bot #8
• /regolamento: stringa + bottone che linka a "https://github.com/MozillaItalia/mozitaantispam_bot/wiki/Regolamento" #9
• /supporto: stringa + bottone che rimanda in home #10 -> /supporto: stringa + bottone che rimanda in home #10 (comment)
• /vademecum: messaggio esplicativo vademecum + tre_bottoni per scaricare vademecum generale tecnico e common voice #27

Comandi deprecati

Comandi "meeting"

• /meeting: avere informazioni sui meeting video mensili comunitari. Stringa + data dell'ipotetico prossimo meeting + bottone "vai al canale youtube"
• /prossimoMeeting
  Per me non servono, l'attività non è grande e c'è il canale Telegram se vogliamo annunciare grandi call. Per tutto il resto c'è Home.

Comandi minori vademecum

• /vademecumGenerale
• /vademecumTecnico
  Non credo che nessuno mai verrà a digitare comandi del genere...

Comandi admin - non prioritari

• /admin: (solo per admin) gestire alcune impostazioni del bot.
  Tutti questi comandi andrebbero deprecati. Non abbiamo niente da gestire in quanto il bot è un "bot vetrina".

Comandi "avvisi"

• /avvisi: vedere lo stato attuale degli avvisi, per attivarli o per disattivarli.
• /avvisiOn: scorciatoia rapida per attivare gli avvisi.
• /avvisiOff: scorciatoia rapida per disattivare gli avvisi.
  Deprecherei anche queste funzioni in quanto non sono più utili (esiste il canale e al limite il gruppo Home).

[Mte90]

Domanda perchè leggendo MozillaItalia/mozitahub_bot#51 non mi è chiaro perchè non vedo un file env di esempio tipo .env-example.

Altra questione il readme di questo progetto menziona antispam bot ma da quello che vedo invece è hub. State valutando una fusione dei due?

[dag7dev]

non vedo un file env di esempio tipo .env-example.

è stato dimenticato nella fretta

progetto menziona antispam bot ma da quello che vedo invece è hub

fixato, era solo un nome errato

[dag7dev]

Ciao a tutti. Siamo a un buon punto, mancano pochissimi comandi per la 0.1.

Riguardo i test: non ho chiuso la issue, ma nulla vieta eventualmente di aggiungere più test.

Chiedo a @Mte90 @Trafitto e @lorenzocamilli di esprimere cosa pensano riguardo i comandi deprecati, ho modificato il primissimo post.
Ho deciso deliberatamente di deprecare quei comandi attualmente presenti sul bot, volevo conoscere la vostra opinione.

[Trafitto]

Hai fatto bene a non chiudere la issue, io ne ho aggiunti solo alcuni il piú é stato trovare una libreria funzionante che mockasse il bot di Telegram, se avete qualche suggerimento per qualche test ma non potete aggiungerli in prima persona pingatemi che a me fa sempre piacere scrivere un test

[lorenzocamilli]

Riguardo i comandi deprecati, a quanto mi risulta i meeting non si fanno più settimanalmente, quindi direi che si possono rimuove entrambi i comandi, siccome eventuali meeting vengono comunicati anche nel gruppo home si saprà da lì quando (e se) ci saranno.

[lorenzocamilli]

Con @dag7dev avevamo parlanto anche di altre cose che non ci convincevano, una che ricordo è il comando "regolamento", se ne parla qui e forse anche vedemecum. Cosa ne pensate?

[Mte90]

Sono d'accordo per rimuovere meeting, possiamo sempre erimplementarlo quando si faranno nuovamente, per il resto ho risposto nei due ticket :-)

[lorenzocamilli]

Per quanto riguarda il comando "vademecum" cosa vogliamo fare? Vogliamo includerli o deprecarli?

[Mte90]

Non abbiamo un comando progetti, con i link ai repo su github? possiamo metterlo li e semplificare.

[dag7dev]

possiamo metterlo li e semplificare.

Nessuno lo vedrebbe però. Sono più dell'opinione di lasciarlo come bottone a sé stante nella pulsantiera...

[Mte90]

Per me una soluzione vale l'altra, l'importante è che ci sia

[dag7dev]

Finalmente si può chiudere questa issue!

Grazie a chi ha contribuito! Che bel traguardo per la nostra community! 🎉 🎉 🎉