Documentation
Ämnesomfång
Sök…
Introduktion
Språkfunktioner Ämnen
En naturlig uppdelning är helt enkelt att skapa ett ämne för varje språkfunktion. Till exempel har Python :
- Klasser
- funktioner
- generatorer
- dekoratörer
- . . .
På nackdelen kan funktioner vara ganska komplicerade och det är lätt att komma med många fler exempel än vettigt för en enda sida. Klasser har till exempel 16 exempel. Vissa av dem kan förmodligen flyttas till andra funktionsämnen, såsom arv, egenskaper, metoder etc.
Ta tag i ämnen
Vissa ämnen är löst associerade exempel under ett tema, till exempel C # 6.0-funktioner och vanliga fallgropar . Sammantaget har den här stilen av ämnet motverkats eftersom exempel per ämne var begränsade eftersom det inte finns någon naturlig plats att sluta lägga till innehåll.
Det är förmodligen bättre att flytta exemplen till ett annat ämne (kanske för språkfunktioner ). Jag har inte sett detta gjort, men det är möjligt att dessa ämnen kan konverteras till ett metatema som innehåller ett exempel eller två som till stor del består av länkar till andra ämnen eller exempel:
Perl tips och tricks
- Analysera inte XML med en regex! Använd en XML-parsingmodul .
- Om du behöver kommentera hela kodblock använder du ett POD-kommentarblock .
- . . .