Chiedo informazioni generali sulla scrittura di glossari

Salve a tutti, sono nuovo del forum (registrato da poco) e questo è il mio primo post. Io sono uno sviluppatore di software, specialmente in ambito Java.

Scrivo perché vorrei chiedere consiglio in generale su come realizzare un “glossario” in LaTeX. Grazie alla mia competenza tecnica, mi piacerebbe realizzare un “glossario della programmazione Java”, descrivendo i tantissimi termini, concetti e acronimi in questo settore. I problemi ora non sono tanto a livello di LaTeX. Conosco discretamente LaTeX, ho già letto guide online, riesco a fare discretamente abbastanza anche se ovviamente non a livello “avanzato”. Ho già visto il pacchetto “glossaries”, ho già fatto qualche prova e non mi pare molto difficile. Al massimo avrò poi sicuramente qualcosa da chiedere riguardo opzioni e aggiustamenti particolari a livello di grafica/layout. Ma non è importante ora.

I miei dubbi sono più a livello concettuale, su quale stile di scrittura adottare per le descrizioni dei termini. La mia idea iniziale era di descrivere i termini e concetti usando non solo una stringata frase (come ho visto in certi glossari) ma qualcosa di più. Qualche paragrafo in più, in modo un po’ più discorsivo, eventualmente se/dove necessario qualche breve pezzo di codice Java per descrivere meglio. L’intenzione però non è di realizzare né un “tutorial” né un “reference”, chiaramente.

Poi cercando informazioni in rete mi sono imbattuto in un documento di un certo Hellmut Riediger “Cos’è la terminologia e come si fa un glossario”, che mi pare ben citato e riconosciuto. Spiegando la “descrizione” dice:

Elemento fondamentale di ogni scheda terminologica, è un enunciato che definisce il concetto e che permette di differenziarlo da altri concetti nell’ambito di un sistema concettuale.
Essa riassume il contenuto semantico del concetto in modo chiaro e sintetico e non deve mai contenere il termine definito.

Ora, per la mia idea iniziale, con una descrizione un po’ più discorsiva e non stringata, mi verrebbe un po’ difficile non poter ripetere il termine descritto.
Quindi a questo punto vorrei chiedere a chi ha più esperienza sui glossari. La indicazione citata è bene seguirla strettamente o comunque il più possibile? O ci possono essere alternative o deroghe? Detto in altro modo: se facessi secondo la mia idea iniziale, il mio glossario potrebbe poi essere visto (da chi se ne intende di glossari, chiaramente) come pessimo o comunque fatto in modo “da incompetenti”?

Grazie in anticipo per suggerimenti utili per iniziare questo mio “percorso” di scrittura.