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

Wed Jul 18 13:11:08 CEST 2012

Azonata,

Overal waar ik heb gewerkt, zie ik gewoon dat documentatie (waar je het
nu in feite over hebt met een wiki) niet wordt bijgewerkt als de drempel
te hoog is.

Die drempel is nu voor veel mensen te hoog -inclusief mij- omdat de
syntax (geen wysiwyg) een drempel opgooid c.q. niet gebruiksvriendelijk.
Inclusief dat navigeren door de wiki voor veel mensen niet intuïtief is.

Deze problemen moeten we gewoon tackelen als organisatie, daar we willen
dat de documentatie up-to-date is, dus continue -laagdrempelig- kan
worden bijgehouden.

Dat kan nu niet.

We kunnen kijken naar een up-grade van wiki naar een alternatief. Dit
geeft veel weerstand enkel om het feit dàt het een wiki is.

Of de gebruikersvriendelijkheid vergroten dmv enkele plugins

Adoptie van de wiki moet enorm hoog zijn, is in het belang van de
organisatie.

We moeten kijken naar de problemen (drempels) die we moeten wegwerken.
Kun je hier wat over zeggen Azonata? Hier wat plugins gevonden;

Navigatie
http://www.dokuwiki.org/plugin:indexmenu

wysiwyg editor (moet wel optie zijn deze aan/uit te kunnen zetten);
http://www.dokuwiki.org/plugin:fckglite

En daarnaast misschien;
http://www.dokuwiki.org/plugin:discussion

Voor beheer;
http://www.dokuwiki.org/plugin:orphanswanted

Kunnen we hier in duiken? Inclusief dan de wiki updaten naar de laatste
versie?

Daarnaast maak ik regelmatig links aan vanuit de hoofdsite naar de wiki,
om te zorgen dat bezoekers meer thuis komen in de structuur en
organisatie. 'k Ben maar eens begonnen met een wiki link op de hoofdsite
onder meedoen :-)

On 18-07-12 12:12, Azonata wrote:
> 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 ingew
 ikkelder

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 at 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.
> 
> 
> 
> _______________________________________________
> Techteam mailing list
> Techteam at lists.piratenpartij.nl
> https://lists.piratenpartij.nl/mailman/listinfo/techteam
> 