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

[Azonata]

Vanzelfsprekend heb ik er niets op tegen om drempels te verlagen en de 
gebruiksvriendelijkheid op te krikken. Ik stel alleen dat van syntax 
wisselen hier op zichzelf weinig aan bijdraagt. Daarentegen erken ik zeker 
dat je een goed punt hebt en dat er zeker iets voor te zeggen is om actief 
oplossingen voor dit probleem te zoeken. Ik ben het dan ook met je eens dat 
plugins enorm kunnen helpen om dit gat tussen de wensen van de organisatie 
en de praktische ervaring voor de internetgebruiker te verkleinen. Wat 
betreft jouw suggesties:

- indexmenu: erg interessant, dit lijkt me zeker de moeite waard om mee te 
experimenteren. Zal kijken of ik hem geïnstalleerd krijg. Echter wel veel 
(complexe) syntax, dus niet direct het meest gebruiksvriendelijk.
- fckglite: dit is misschien wel de belangrijkste plugin om de door jouw 
gestelde drempels weg te nemen, nu ik het zo zie is het eigenlijk gewoon 
iets wat we veel eerder hadden moeten hebben. Ik zal hem gelijk installeren.
- discussion: op zich heeft iedere pagina al een talk page zoals wikipedia, 
dus de directe bijdrage van deze plugin is denk ik beperkt, vooral om dat de 
meeste mensen vooral affiniteit met talk pages hebben.
- orphanswanted: dit lijkt me wederom een goede toevoeging, al heeft onze 
wiki momenteel vrijwel geen orphans, aangezien de manier waarop ik te werk 
ben gegaan is om alleen links te plaatsen naar bestaande artikelen. Maar 
daarmee kan het zeker geen kwaad.

Ik zal kijken wat er met deze plugins mogelijk is, want ik wil net zo goed 
als ieder ander dat we zoveel mogelijk mensen op de wiki actief krijgen. Ik 
probeer eveneens om de wiki bij zoveel mogelijk relevante en interessante 
projecten te betrekken (verkiezingen, werkgroephandleidingen, faq etc. etc) 
zodat mensen er op een laagdrempelige manier mee in aanraking komen en zich 
vervolgens aangesproken zouden kunnen voelen om een bijdrage te leveren. 
Alle links naar de wiki zijn daarbij natuurlijk ook mooi meegenomen, dus 
dank daarvoor :)

-----Oorspronkelijk bericht----- 
From: Bob Sikkema | DigitalForce.eu
Sent: Wednesday, July 18, 2012 1:11 PM
To: techteam op lists.piratenpartij.nl
Subject: Re: [PPNL-Techteam] Wiki vs Redmine vs Drupal vs Github 
Re:csffirewall

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