Documentatie standaard overzicht
Als je een bijdrage wilt leveren aan de TikiWiki documentatie, Houd dan AUB rekening met de onderstaande standaards.
Basis Concepten:
- Pagina In de TikiWiki documentatie, de term pagina(page) is synoniem aan Wiki pagina.
- Onderdeel Een onderdeel(feature) is een TikiWiki component met een specifieke functie, zoals de beeld-gallerijen, bestands-gallerijen, FAQs, banners, forums, of blogs (bekijk Onderdelen voor een overzicht).
Alle pagina's worden geïntergreerd door middel van een Wiki struktuur
- Standaarden
Voor voorbeelden bekijk Voorbeelden
Elke pagina moet een standaard opmaak gebruikenOpmaak Standaarden Ga naar Benodigdheden en instelling voor een voorbeeld.
- Status
De Documentatie Status is de "harcoded" en beschreven versie van de struktuur. Als je nieuwe pagina's toevoegt, plaats er dan AUB een duidelijke indicatie bij TOEVOEGEN zodat het toegevoegt kan worden aan een struktuur. Opruimingen en pagina's verplaatsen gebeuren regelmatig.
Elk Onderdeel heeft op zijn MINST vier pagina's Documentatie.
- Hoofd pagina
voor een voorbeeld Blogs
Dit is de top-level pagina van dit onderdeel. Het defineert de strekking van het onderdeel, en geeft een overzicht van de mogelijkheden van het onderdeel(Wat er vele kunnen zijn, dus worden ze hier beknopt beschreven), Tevens wijst hij de weg naar gerelateerde interne of externe bronnen.
- Gebruikers Hulp
voor een voorbeeld Blogs gebruiken
Deze hulp is ontworpen voor eind-gebruikers(inclusief admins die hun site gebruiken). Elk van de Gebruikers pagina's zou georganiseert moeten worden door Taken, dat is, wat een gebruiker wil bereiken(als voorbeeld, "Maak een nieuwe Blog aan," "Voorkomen dat andere gebruikers dingen aanleveren," etc.). Gebruik Screenshots vrijelijk!
- Admin Uitleg
voor een voorbeeld Blogs beheren
Deze Uitleg voorziet alles wat een Admin nodig heeft om dingen te starten, configureren, onderhouden, en probleem aan het onderdeel te kunnen doen. Waar nodig, zou het ook systeem informatie benodigdheden moeten bevatten, Of andere bruikbare vanuit het Admin oogpunt.
- Referencies
voor een voorbeeld Blogs referencies
Dit is de referencie documentatie. Het zou lijsten met korte omschrijving van de volgende dingen moeten bevatten.
- rechten relevant aan het onderdeel,
- contstante database tabellen,
- administratieve configuratie mogelijkheden,
- gebruikers mogelijkheden.
Hoe te starten
- Editor wezen
Elke tikiwiki community member die is verklaart als zodanig op tikiwiki.org krijgt een Editors vlag op zijn documentatie website.
- kies een onderwerp of onderdeel
Van de Documentatie Status pagina, kies je een onderdeel waarvan je wilt helpen de documentatie te maken.
- Inhoud vinden
Plunder http://tikiwiki.org als daar al documentatie is te vinden. Zo ja, copieër het en plaats de documentatie hier. Opmerking: Hou er rekening mee dat het niet in de juiste formaat is! Je kan ook uit oude 1.6 TikiWiki de documentatie zuigen klik http://alt.thetinfoilhat.com/tiki-index_raw.php?page=Tiki%20Documentation om mischien wat meer info te vinden(het meeste zal al overgezet zijn naar tikiwiki.org).
- Schrijf wat er ontbreekt
Schrijf of bewerk de pagina zo dat hij volgens het relevante voorbeeld en zo nauwkeuris als mogelijk (bekijk Voorbeelden ). Controleer Opmaak Standaarden om zeker te zijn dat de afhandeling van "mechanical matters" zoals headings, links, etc., correct worden afgehandeld.
- Werk groepsgericht
Update Documentatie Status zo dat andere deelnemers weten waaraan je werkt (en wat er nog gedaan moet worden).
|