Ricerca…


introduzione

Gli argomenti dovrebbero essere il più semplici possibile, ma non più semplici. Questo suggerisce alcuni principi organizzativi visti su Stack Overflow Documentation.

Argomento della funzione di lingua

Una divisione naturale è semplicemente quella di creare un argomento per ogni caratteristica linguistica. Ad esempio, Python ha:

  • Classi
  • funzioni
  • generatori
  • decoratori
  • . . .

Al rovescio della medaglia, le funzionalità possono essere piuttosto complicate ed è facile trovare molti più esempi di quelli necessari per una singola pagina. Le classi hanno 16 esempi, per esempio. Alcuni di questi potrebbero probabilmente essere spostati su altri argomenti di funzionalità, come l'ereditarietà, le proprietà, i metodi, ecc.

Argomenti della borsa a mano

Alcuni argomenti sono esempi liberamente associati a un tema, ad esempio C # 6.0 Funzionalità e problemi comuni . Nel complesso, questo tipo di argomento è stato scoraggiato dal momento che gli esempi per argomento erano limitati in quanto non esiste un luogo naturale in cui interrompere l'aggiunta di contenuti.

Probabilmente è meglio spostare gli esempi su un altro argomento (forse per le funzionalità linguistiche ). Non ho visto questo fatto, ma è possibile che questi argomenti possano essere convertiti in un meta topic che include un esempio o due che consiste in gran parte di collegamenti ad altri argomenti o esempi:

Perl suggerimenti e trucchi



Modified text is an extract of the original Stack Overflow Documentation
Autorizzato sotto CC BY-SA 3.0
Non affiliato con Stack Overflow