[phpMyAdmin Developers] Wiki

Wed Jun 15 03:16:52 CEST 2016

Sebastian, I'm glad to hear from you.

On 6/13/16 11:54 AM, Sebastian Mendel wrote:
> I am not sure what type of git integration you are looking for, but I
> like Atlassian Confluence:
> https://de.atlassian.com/software/views/open-source-license-request

I have not used it yet. Do you mind sharing briefly what you like about
it? Does it allow for offline editing like we can do using the github wiki?

> Isaac Bennetch <bennetch at gmail.com <mailto:bennetch at gmail.com>> schrieb
> am Mo., 13. Juni 2016, 15:08:
> 
> 
> 
>     On 6/13/16 8:02 AM, Michal Čihař wrote:
>     > Hi
>     >
>     > this topic was discussed quite a lot on the mailing list, but
>     still I'd
>     > like to hear feedback which solution do you prefer.
>     >
>     > Dne 8.6.2016 v 13:33 Michal Čihař napsal(a):
>     >> Possible solutions:
>     >>
>     >> * bring Mediawiki on wiki.phpmyadmin.net
>     <http://wiki.phpmyadmin.net> back to usable state
>     >>
>     >>   - we will have to handle security fixes and so on
>     >>   - need some way to prevent vandalism
>     >
>     > Alec Teal offered help with this. The best approach here is
>     probably to
>     > start with updating latest Mediawiki and avoid using Debian packages
>     > completely.
> 
>     I am not against staying with Mediawiki, however the obvious shortcoming
>     is lack of git integration. This is not a deal-killer for me, but it is
>     a negative.
> 
>     >> * use wiki on GitHub
>     >>
>     >>   - it's for free with the repository
>     >>   - the wiki is quite limited (no categories, no search, ...)
>     >>   - having wiki content as Git repository is great
>     >
>     > The wiki features are rather limited here, on the other side we really
>     > did not use much of them anyway...
> 
>     We can work around the lack of features, since there aren't many we use,
>     but the limitations with how data is displayed (for instance, only about
>     70% of the page is used for actual wiki data) make this difficult. I'm
>     not fond of Github wiki and only consider it because it's easy and has
>     great git integration.
> 
>     >> * use other solution for wiki.phpmyadmin.net
>     <http://wiki.phpmyadmin.net>
>     >>
>     >>   - we could use cleaned up wiki content which is currently used
>     on GitHub
>     >>   - I'd really prefer something with Git integration
>     >>   - preferably use GitHub authentication, so that we do not have to
>     >> maintain another list of users
>     >>   - one of possible tools to do that is ikiwiki
>     >
>     > Anybody has experience with ikiwiki or other wiki engines?
> 
>     I've been looking in to ikiwiki, actually. It has git integration, which
>     I think is the feature we're most looking for. The underlying language
>     is Markdown, which we're rather familiar with. However, the rendered
>     pages are a bit ugly.
> 
>     You can quickly clone the repository with
>     > git clone git://ikiwiki.branchable.com/
>     <http://ikiwiki.branchable.com/>
>     to view the demo wiki. Look in the ./doc/ folder for the actual wiki
>     content. The rendered pages are visible at https://ikiwiki.info/
> 
>     They appear to allow authentication using accounts from OpenID, Yahoo,
>     WordPress, and more; in fact there's a page with discussion about their
>     plans/roadmap for authentication[1]. However, it seems the path to
>     OpenID is a bumpy one[2].
> 
>     I'm more excited about Gitit[3][4]. Gitit has a git backend (or darcs or
>     mercurial), pages are able to be written in about ten different flavors
>     including Markdown and reStructuredText (anything understood by Pandoc),
>     and it looks like Mediawiki (which isn't a big goal for me, but it's a
>     common and easy-to-use structure). The default/suggested authentication
>     seems to be GitHub OAuth. Downsides about it: their own wiki is a mess
>     (broken links to the Install guide and README, not a whole lot of
>     information in general), development seems slow (there are plenty of
>     Issues and Pull Requests without a comment, last commit was 12 days
>     ago), and it's written in Haskell (with which I'm not very familiar) --
>     but this is my favorite right now. This random guy[5] has similar goals
>     to ours and settled on Gitit.
> 
>     Finally, there is Realms[6][7] and Gollum[8]. Realms is built on Gollum,
>     uses GitHub OAuth, and it looks really modern. However, the
>     documentation seems really weak and it looks like they haven't published
>     an actual release yet (though running their git 'master' branch seems to
>     work okay). Realms is very interesting to me, but with my cursory
>     examination it doesn't feel like production-ready software. I could be
>     wrong. Gollum is apparently what GitHub is using for their wiki engine.
>     I don't have a good sense of what Gollum is like, because as near as I
>     can tell they don't have a demo and I haven't gotten around to
>     installing it on my test machine. There's a fork to add OAuth
>     support[9].
> 
>     For looks, I think Realms acts best; it's modern and slick and easy to
>     use. However, Gitit seems much more established and reliable.
> 
> 
>     1 - https://ikiwiki.info/todo/emailauth/
>     2 - https://ikiwiki.info/plugins/openid/troubleshooting/
>     3 - http://gitit.net/
>     4 - https://github.com/jgm/gitit
>     5 - http://nathantypanski.com/blog/2014-07-09-personal-wiki.html
>     6 - http://realms.io/
>     7 - https://github.com/scragg0x/realms-wiki
>     8 - https://github.com/gollum/gollum
>     9 - https://github.com/aleiphoenix/gollum-with-auth
> 
>     _______________________________________________
>     Developers mailing list
>     Developers at phpmyadmin.net <mailto:Developers at phpmyadmin.net>
>     https://lists.phpmyadmin.net/mailman/listinfo/developers
> 
> 
> 
> _______________________________________________
> Developers mailing list
> Developers at phpmyadmin.net
> https://lists.phpmyadmin.net/mailman/listinfo/developers
> 