[PPNL-Techteam] Wiki vs Redmine vs Drupal vs Github Re: csffirewall

[Azonata]

Persoonlijk wordt ik altijd maar moe van alle discussies over welke wiki syntax nu weer de beste zou moeten zijn. Iedereen heeft zijn eigen voorkeur, en de verschillen zijn minimaal. Om van je persoonlijke voorkeur af te moeten stappen is natuurlijk nooit leuk, maar In de praktijk kost het je een paar uur en dan kun je er net zo goed over weg als met elke andere. Dokuwiki doet het prima naar mijn mening, het heeft veel opties, is goed gedocumenteerd en in mijn ervaring pikt een meerderheid van de wiki editors de basisprincipes snel genoeg op. In plaats van een eeuwige discussie over syntax te houden lijkt me veel belangrijker dat wiki editors elkaar bijspringen. Als iemand bijvoorbeeld een pagina typt maar helemaal in de knoop raakt met de syntax kan een andere editor dit in slechts enkele minuten voor hem/haar fixen. Het is immers op de eerste plek een community project waar niet iedereen een pro editor hoeft te zijn om een bijdrage te leveren. Dit ligt misschien wat ingewikkelder voor de technische documentatie die jullie op de wiki willen zetten, maar voor de overige 99% van de wiki hoeft er wat mij betreft niets aan de syntax te veranderen (en ja het feit dat die 99% voor het overgrote deel door mij er in is gezet speelt daarbij zeker een rol in mijn argumentatie, maar dat spreekt denk ik voor zich). 

Als de syntax echt een onoverkomelijk obstakel blijkt dan kun je info voor de wiki (als het al ergens anders staat) ook altijd naar wiki op piratenpartij.nl sturen, en dan zorg ik dat het er ASAP op komt te staan, met syntax volledig en wel.

Vriendelijke groet,
Henry

-----Oorspronkelijk bericht----- 
From: Casper Gielen 
Sent: Wednesday, July 18, 2012 10:17 AM 
To: Techteam PiratenPartij Nederland 
Subject: Re: [PPNL-Techteam] Wiki vs Redmine vs Drupal vs Github Re: csffirewall 

On 18-07-12 09:48, Bèr Kessels wrote:
> En dan even mijn idee en voorkeuren op mijn eigen vragen :P
>
> 1. Redmine: Alleen security- en privacy-gevoelige data. Nooit meer dan dat.
>     Wiki: Alle generieke info voor het techteam zelf en voor mensen die
> met het techteam te maken hebben. AKA: moeten nieuwe techteamleden het
> weten of vinden? Dan wiki. Moeten bestuur, comm., pr, grafish, etc er
> vanaf weten? dan wiki.
>     Drupal OG: Werkdocumenten, soort /tmp, heel project-speficieke docs.
> Al zal ik die pers. liever in het desbetreffende git-project zelf zetten.
>     Iedere entry op redmine wordt gelinkt vanaf de wiki.
> 2. Wiki: k*tsyntax, maar is even niet anders. Liefst zie ik markdown:
> simpeler, noob-friendly en ben ik aan gewend :) Mogelijk in toekomst een
> syntax-highlight plugin, als we meer technisch-inhoudelijk (zoals
> conf-files en code-voorbeelden) gaan documenteren. Nu nog niet nodig.
>     Drupal OG: nog ergere k*tsyntax voor documentatie, verergerd door een
> WYSIWYG. Ook markdown; maar omdat deze in het hele drupal-sitezit,
> helaas niet makkelijk mogelijk zonder de rest van de site te verstoren.
>     Redmine: niets.

Ik ben het grotendeels met je eens en heb net een mail gestuurd met 
ongeveer dezelfde inhoud.

Alles in git zetten (bv in markdown-formaat) is wat mij betreft ook 
goed, zo doe ik het zelf ook (voor mij is alles een tekstfile die ik in 
versiebeheer heb zitten).
Ik ben alleen bang dat onze gebruikers die info niet gaan vinden en dat 
de drempel om te helpen met de documentatie erg hoog wordt. De wiki is 
voor iedereen toegankelijk en al bekend bij de actievere piraten.

Persoonlijk vind ik het verschil tussen de Dokuwiki-syntax en Markdown 
niet zo heel spannend maar mijn ervaring met beide is beperkt. Ik heb 
geen sterke voorkeur voor het een of het ander.

-- 
Casper
_______________________________________________
Techteam mailing list
Techteam op lists.piratenpartij.nl
https://lists.piratenpartij.nl/mailman/listinfo/techteam
------------- volgend deel ------------
Een HTML-bijlage is gescrubt...
URL: <https://lists.piratenpartij.nl/mailman/private/techteam/attachments/20120718/f99c5f38/attachment-0001.html>