Loomio
Fri 31 Aug 2012 10:50PM

Documentation platform

T twain Public Seen by 34
ST

Sean Tilley Wed 12 Sep 2012 4:14PM

No, we should keep discussion on here for the most part. I don't want to have to check three or four different sites just to have a conversation. ;)

A

altruism Wed 12 Sep 2012 4:17PM

Sean, I think he meant a sub-group here in Loomio.

ST

Sean Tilley Wed 12 Sep 2012 4:18PM

Oh. :P

JH

Jordan H Tue 18 Sep 2012 8:26PM

One suggestion I have: we could use the Wiki for macro-level documentation (what certain folders are used for, and so on) and use Doxygen for code-level documentation for easy look-up.
I am confused as to where documentation is being used. Stack Exchange or Wiki?

ST

Sean Tilley Tue 18 Sep 2012 9:14PM

Currently, all documentation is located on our GitHub repo's wiki. However, as we're thinking about some changes in infrastructure, we're considering better options.

So far, two of the more practical options (if we go the self-hosted route) are as follows:

1.) Use MediaWiki. MW is tried-and-true, and is pretty easy to organize.

2.) Build into Drupal using a wikitools and FreeLinking module set. The upside of this is that we can integrate wiki functionality directly into the Drupal platform, which could serve several other functions as a central project site, and provide a useful set of reasons to register a single account.

G

goob Tue 18 Sep 2012 10:20PM

I think a self-hosted wiki would be the best way forward. I can't really comment on the technical benefits of different systems as I don't know anything about them, so will leave that up to those who do. It sounds promising.