De handleiding
Welkom bij het kookboek, de nieuwe CakePHP documentatie. Het cakeboek is een wiki-like systeem dat bijdrage van het publiek toestaat. Met een open systeem hopen we het volgende te behouden: hoge kwaliteit, validatie en accurate informatie voor documentatie van CakePHP. Het kookboek maakt het voor iedereen makkelijk om een bijdrage te leveren.
Grote dank gaat uit naar AD7six door talloze uren van ontwikkeling, testen en verbetering van deze applicatie.
# Hoe werkt het
- U bezoekt de site en ontdekt een fout, iets dat onvolledig is, iets dat in zijn geheel niet genoemd wordt of iets dat niet geformuleerd is zoals u dit zou willen.
- Log in Cookbook met uw Bakery login.
- Stuur toevoegingen/bewerkingen in met behulp van valide, semantische HTML.
- Kom een andere dag terug om te zien of uw wijzigingen zijn goedgekeurd.
- Lees de richtlijnen voor het leveren van een bijdrage om consistentie (samenhang) te waarborgen. (Binnenkort in het Nederlands)
# Vertalingen
Stuur een e-mail naar John David Anderson (docs at cakephp dot org) of contacteer hem op het IRC kanaal (te vinden als _psychic_ in #cakephp op freenode) om te bespreken met welke taken op vertaalgebied je wilt meewerken.
Tips voor vertalers:
- Gebruik geen html entiteiten voor karakters met een accent, want de handleiding gebruikt UTF-8.
- Gebruik de informele vorm.
- Vertaal de inhoud en de titel tegelijkertijd.
- Browse en bewerk de handleiding in de taal waar naar vertaald wordt - anders worden wijzigingen opgeslagen als Engelstalige bewerkingen met slechts een kleine kans dat de reviewer weet in welke taal je schrijft.
- Verander de opmaak niet significant en voeg geen nieuwe inhoud toe. Als het origineel informatie mist, voeg deze dan eerst toe.
- Wijzig interne links zodat verwezen wordt naar de vertaalde taal.
- Als je een Engelse term moet gebruiken, schrijf deze dan in
<em>tags. Bijv. "asdf asdf Controller asdf" of "asdf asdf Kontroller (Controller) asfd".
We hebben ons tot doel gesteld om de documentatie voor CakePHP beter te maken dan het ooit is geweest. We hope dat je met ons mee zult werken door het Cookbook te gebruiken en iets terug te geven aan een project waar we allemaal veel voordeel van hebben gehad.
