Loomio

Documentation platform

T twain Fri 31 Aug 2012 10:50PM Public Seen by 34
T

twain Fri 31 Aug 2012 10:50PM

Which platform do you prefer? I think MediaWiki is a good choice. It's pupular and easy to use. It's easy for everybody to fix mistakes and translate the docu.

T

MediaWiki

proposal by twain Closed Mon 3 Sep 2012 2:18PM

What do you think of MediaWiki?

Results

Results Option Votes % of votes cast % of eligible voters
Agree 0 0 0  
Abstain 4 100 19 ST FS HF BO
Disagree 0 0 0  
Block 0 0 0  
Undecided 17 81 MS S JH JR F M G T DY SH DU DS PP W A RF Y

4 of 21 votes cast (19% participation)

ST

Sean Tilley
Abstain
Fri 31 Aug 2012 11:20PM

Dunno how I feel about MediaWiki. It's robust, true, but we'll also need to think of where to host it if we switch to it. Regardless of platform, we need to ensure easy doc navigation to minimize clutter.

HF

Hans Fase
Abstain
Sat 1 Sep 2012 6:21PM

I am kinda neutral on this, while I think the Github wiki could be better there are still other options rather than going with MediaWiki.

One option I mentioned before was using a Octopress or Jekyll based site...

FS

Florian Staudacher
Abstain
Sun 2 Sep 2012 12:29AM

doesn't have to be mediawiki. I have some experience with it and I really like it, but there might be better choices out there for documentation of a software project...

ST

Sean Tilley Fri 31 Aug 2012 11:15PM

Not sure how I feel about MediaWiki really. Although I will agree that GitHub's Wiki reaches a bit short of what we want it to do, we have to consider two things:

1.) The wiki, from a usability standpoint, should be pretty simple and easy to navigate.

2.) If we're doing MediaWiki, then we should find a place to host it from within the Diaspora community infrastructure.

Truth be told, one of the loom.io team members told me that they plan on bringing wiki functionality to loom.io itself. I'm a little curious to see as to whether that might be useful.

T

twain Sun 2 Sep 2012 1:10PM

Which platform do you prefer? suggestions?

T

twain Sun 2 Sep 2012 1:18PM

...because of hosting. when we gonna use loom we have to host it to right? So the hosting problem is a problem we have surely.

T

twain Sun 2 Sep 2012 1:54PM

What do you think of using LaTeX and converting this to html?
For working together we could use git, exchanging the LaTeX files. I have no experience with this, just an idea.
I think its not so easy for newcomers to join the docu team or just write a short tutorial with LaTeX.
In my opinion it's important that it is easy for everybody to improve or write articles.

A

altruism Tue 11 Sep 2012 10:11PM

Florian, "...but there might be better choices out there for documentation of a software project" such as? I'm interested to know about our options (concurrent proposals).

Load More