[Scons-dev] What to replace the wiki with?

[Gary Oberbrunner]

Here's a wiki progress report.

* I've re-enabled the regular wiki, in read-only mode.  That way at least
people can see it.  Pair may take it down again but it's better than
nothing.
* I put up test versions of the wiki, converted to markdown, on both
bitbucket and github.
  - bitbucket: https://bitbucket.org/scons/scons/wiki/FrontPage (this is
backed by an hg repo)
  - github: https://github.com/garyo/scons-wiki/wiki/FrontPage (this is
backed by a git repo)

IMHO, the bitbucket version looks better.  They both are functional.  They
both have online editors, and both allow specifying a list of approved
contributors who can edit directly, without making pull requests.  They are
both DVCS-backed and can accept pull requests (I think, haven't tried
that.)  I don't know much yet about searchability or TOCs.

Feel free to play with them (but don't expect your changes to persist
forever, these are just tests).  Please let me know what you find.

The conversion process to markdown was _definitely_ not perfect.  There are
many little errors and markup oddities that would need to be cleaned up by
hand.  Tables especially suffer, since Markdown's table support is minimal.
(there is no rowspan support for instance.)  There may be ways to fix the
conversion script and re-run the conversion as we find global conversion
issues.  The FrontPage looks particularly bad, but don't judge the
conversion process by that, since it has much more custom markup than most
of the regular pages.

-- Gary


On Sat, Dec 13, 2014 at 5:58 AM, anatoly techtonik <techtonik at gmail.com>
wrote:
>
> On Sat, Dec 13, 2014 at 12:45 PM, Dirk Bächle <tshortik at gmx.de> wrote:
> > Someone has to accept (and review?) all the incoming pull requests. And
> you
> > can't simply mark persons "trustworthy for the future", as with the
> > ApprovalQueue. So you have to accept/merge each time...just sayin'.
>
> I completely agree with that. Python wiki restricted all people of editing
> and now it is AFP. There should be a way with more flexible control over
> workflow. ApprovalQueue could only be used to moderate first edit and
> should be fast, so that people from IRC can approve edits quickly.
>
> There is some ready to use piece of code that is possible to adopt
> assuming that there is a sane amount of hackers who are not hacking
> on SCons code ATM or need a rest
> https://github.com/zacharyvoase/markdoc/network
> _______________________________________________
> Scons-dev mailing list
> Scons-dev at scons.org
> https://pairlist2.pair.net/mailman/listinfo/scons-dev
>


-- 
Gary
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://pairlist2.pair.net/pipermail/scons-dev/attachments/20141213/5928369f/attachment.html>