[phpMyAdmin Developers] Wiki

Sebastian Mendel info at sebastianmendel.de
Thu Jun 16 21:19:48 CEST 2016


> I have not used it yet. Do you mind sharing briefly what you like about
it?

It works ;-)
The hosted version does not require any of your short time for maintaining
the system.
It is easy to use - IMHO.
It is feature-rich.

> Does it allow for offline editing like we can do using the github wiki?

It supports editing with local editors - i do not know if this requires an
active connection.
But is provides an API.


As auth provider it accepts only itself (My Atlassian) or google business
:-(




Isaac Bennetch <bennetch at gmail.com> schrieb am Mi., 15. Juni 2016 um
03:16 Uhr:

> 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
> >
>
> _______________________________________________
> 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/20160616/ba88dc32/attachment.html>


More information about the Developers mailing list