[phpMyAdmin Developers] Wiki

[Sebastian Mendel]

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

Isaac Bennetch <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 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
> >>
> >>   - 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/
> 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
> https://lists.phpmyadmin.net/mailman/listinfo/developers
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.phpmyadmin.net/pipermail/developers/attachments/20160613/109f199e/attachment-0001.html>