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

[alexandre.feblot at gmail.com]

Hi,
Just a side remark, as a former user of that wiki:
The issue is that most of it is outdated: refers to obsolete methods, uses Python methods whereas there is now a SCons method, etc...
And even when it's not, readers don't trust fully what they see, because, well, how can they know if this is still up to date or not?
And this is caused by the very use of a wiki to hold/update the data.

Whereas if all of this could be integrated in the **official** doc, and as such, be maintained/updated to follow SCons evolution, it would bring much more value to it.


Le 13 déc. 2014 à 17:37, Dirk Bächle <tshortik at gmx.de> a écrit :

> Gary,
> 
> On 13.12.2014 15:06, Gary Oberbrunner wrote:
>> 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.
>> 
> this is awesome! For me, both of the options look good enough to give them a go. The "bitbucket" version is my winner, because it uses the full page width for content. I think this is important, e.g. for places where we quote source passages with longer lines...
> 
> One other thing I noticed is, that on the "SconsIsNotSlow" page the attached files were successfully converted...but the images seem to be missing. Maybe there is a convert option for that?
> Otherwise, as I said above, it's perfectly good to start from here and manually improve pages where required.
> 
> Dirk
> 
> 
> _______________________________________________
> Scons-dev mailing list
> Scons-dev at scons.org
> https://pairlist2.pair.net/mailman/listinfo/scons-dev