DocumenteerStandaarden

Ga naar: navigatie, zoeken

Basis richtlijnen

  • CreĆ«er de wiki pagina onder Standaarden/
  • Als de standaard nieuw is, documenteer dan a.u.b. gebruik, vereisten, beperkingen, enz...
  • Als de standaard zijn eigen bestaande specificatie heeft, link er dan naar, documenteer extensies.
  • De toegevoegde waarde van de openSUSE wiki is om te helpen deze specificaties te implementeren en verbeteren.
  • Geef voorbeelden. Tekst heeft het laatste woord, Maar om te implementeren zegt een voorbeeld veel meer.
  • Wanneer je XML gebaseerde talen documenteert, gebruik dan het reeds gedefinieerde schema of dtd en breidt het uit.
  • Als uw XML nog geen specificatie heeft, neem dan een kijkje op XML standaarden
  • Als de standaard nog niet is gebruikt, en op grote schaal geaccepteerd is (het is nog steeds een idee) markeer de wiki pagina dan a.u.b. met het VoorgesteldeStandaard sjabloon.
  • Als de openSUSE versie van de standaard het origineel uitbreidt of aanpast, documenteer dit dan, en markeer de aanpassing met het NovellStandaardExtensie sjabloon.


XML Standaarden

  • Wanneer een specificatie niet beschikbaar is, documenteer het aan de hand van relaxng compact syntax
  • U kan het trang programma gebruiken om DTD's en andere XML schema's te converteren naar elkaar.