[sr-dev] [SR-Users] new wiki system

[Daniel-Constantin Mierla]

Hello,

On 10/4/11 6:44 PM, Henning Westerholt wrote:
> On Monday 03 October 2011, Daniel-Constantin Mierla wrote:
>>> As suggestion, not related to the content, I'd change the theme. That red
>>> looks very agressive to me.
>> I chose it for the fonts which are easier (imo) to read comparing with
>> other themes. It is on to-do to make it greenish - replace red borders
>> with some nuance of green), to match better the style of kamailio color
>> scheme, but not that much high in top of current priorities. Suggestions
>> and contributions in this regards as also welcome, of course.
> Hi Daniel,
>
> first of all, thank you for working on it. Its indeed looks really red right
> now, not really pleasing to the eyes. ;-) .
maybe it is the contrast, on my screen is ok to work with, anyhow until 
I get to it, I will work first on content, but maybe someone will 
contribute an adjustment to the theme.

>   So you mentioned  that its not
> planned to switch off the "old" wiki system, so in the future user needs look
> in two locations for documentation?
it will be one place to look at for each of major versions, up to 3.1.x 
old wiki, from 3.2.x on, to the new wiki. Like we had with source 
repository, up to a version to svn, then git.

>
> Just an idea, have you thought about just moving the current content aside,
> maybe to some "obselete, needs to be updated" section in the current wiki
> overview, but keep the existing content for our older releases? Then we also
> save the effort to manually migrate the stuff for the older releases.
There is not really obsolete content, being valid for old versions and 
many people are using such releases. My goal is to get to something more 
clear for new comers starting with 3.2.0, in the way that what is in the 
new wiki system is valid documentation for that version. The old wiki 
has so many pages, being easy to get lost, still good content to keep it 
available.

Of course, any effort from someone to make old wiki better organized 
will be very appreciated, eventually each tutorial to have at the top 
the page the list of versions for which it is valid. I don't have any 
spare time, considering the volume of documents to be made ready for 
3.2.0 release and the number of volunteers working on documentation... ;-)

And the end of the day, both wikis are using dokuwiki, so merging at 
some point will be a matter of copy and paste, but now feels better to 
work on a fresh place, from my point of view.

Cheers,
Daniel

-- 
Daniel-Constantin Mierla -- http://www.asipto.com
Kamailio Advanced Training, Dec 5-8, Berlin: http://asipto.com/u/kat
http://linkedin.com/in/miconda -- http://twitter.com/miconda