Prepara il lancio

Prima di essere pronto a lanciare la traccia, assicurati che le seguenti attività siano state completate.

Richiedi l'icona della traccia

Per progettare un'icona per il sito, apri una nuova issue nel repository exercism/website-icons, rispondendo alle seguenti domande:

  • Il linguaggio ha un logo ufficiale? Se sì
    • includi un link a un esempio
    • elenca i requisiti di attribuzione e i diritti concessi per l'uso di quel logo
  • Il linguaggio ha un logo non ufficiale? Se sì
    • spiega in che modi le persone usano il logo non ufficiale
    • includi un link a un esempio
    • elenca i requisiti di attribuzione di quel logo

Aggiungi la documentazione della traccia

Aggiungi i seguenti documenti della traccia:

  • docs/ABOUT.md: una breve introduzione al linguaggio.
  • docs/INSTALLATION.md: descrivi cosa deve installare lo studente per poter lavorare alla traccia sul proprio sistema locale usando la CLI.
  • docs/LEARNING.md: link a risorse per l'apprendimento.
  • docs/RESOURCES.md: link a risorse utili.
  • docs/TESTS.md: descrivi tutto ciò che riguarda l'esecuzione dei test nella traccia.

Questi documenti aiuteranno lo studente a iniziare con la traccia e a conoscere la traccia e il suo linguaggio. Per maggiori informazioni, consulta la documentazione sui docs.

Aggiungi la documentazione degli esercizi

Aggiungi i seguenti documenti degli esercizi:

  • exercises/shared/.docs/help.md: contiene istruzioni specifiche della traccia su come ottenere aiuto
  • exercises/shared/.docs/tests.md: contiene istruzioni specifiche della traccia su come eseguire i test

Aggiungi un frammento di codice

Aggiungi un frammento di codice al file docs/SNIPPET.txt. Questo frammento dà un'impressione visiva di come appare la sintassi del linguaggio. Per maggiori informazioni, consulta la documentazione sui docs.

Aggiorna i metadati

I metadati della traccia sono definiti nel file config.json. Le seguenti proprietà vanno aggiornate:

  • language: il linguaggio della traccia (ad es. "C#"). La sua lunghezza deve essere <= 255
  • slug: il linguaggio della traccia come stringa in minuscolo e in kebab-case (ad es. "csharp"). La sua lunghezza deve essere <= 255
  • blurb: una breve descrizione del linguaggio. La sua lunghezza deve essere <= 400
  • online_editor: un oggetto che descrive le impostazioni usate per l'editor online:
    • indent_style: può essere "space" o "tab"
    • indent_size: la dimensione dell'indentazione come numero intero (ad es. 4)
    • highlightjs_language: l'identificatore del linguaggio per Highlight.js (vedi la lista completa degli identificatori). Se Highlight.js non è supportato, questo campo può essere omesso.
  • key_features: le funzionalità principali del linguaggio, che ne descrivono in modo conciso le caratteristiche più importanti. Per maggiori informazioni, consulta la documentazione sulle funzionalità principali.
  • tags: definisci i tag che si applicano a questa traccia, il che permette di cercarla sul sito. Per maggiori informazioni e per l'elenco dei tag supportati, consulta la documentazione sui tag.