[asterisk-dev] [svn-commits] lathama: branch 1.6.2 r305752 - /branches/1.6.2/channels/chan_sip.c

[Olle E. Johansson]

3 feb 2011 kl. 12.13 skrev Andrew Latham:

> On Thu, Feb 3, 2011 at 8:05 AM, Olle E. Johansson <oej at edvina.net> wrote:
>> 
>> 3 feb 2011 kl. 11.59 skrev Russell Bryant:
>> 
>>> 
>>> ----- Original Message -----
>>>> 3 feb 2011 kl. 11.45 skrev Russell Bryant:
>>> 
>>>>>> Can we make the URL configurable? I think distributions like
>>>>>> Switchvox
>>>>>> might want to refer to their own web site instead of the one at
>>>>>> asterisk.org.
>>>>> 
>>>>> I'm not sure it's practical. If it were one configuration item,
>>>>> that's not a big deal. It would require a configuration option for
>>>>> every document we want to refer to, which is quite a few. This is
>>>>> not something that has ever been requested by Switchvox
>>>>> specifically. What's the benefit?
>>>> 
>>>> I did not mean the full URL, but the base,
>>>> https://wiki.asterisk.org/wiki/display/AST
>>>> 
>>>> I think there are a lot of Asterisk vendors that would like to
>>>> customize that - the might have docs in another language or want their
>>>> own logo on it.
>>> 
>>> Do you want to do it?
>>> 
>>> Keep in mind that making the base URL configurable is only useful if the exact same URL scheme is used (probably the same wiki software with identical pages).  That seems unlikely.
>>> 
>>> Another relevant piece of information here is that the license that the wiki content is distributed under prohibits use of the content for commercial purposes.
>>> 
>>> http://creativecommons.org/licenses/by-nc-nd/3.0/us/
>> 
>> 
>> I did not understand that Digium has relicensed material I committed under new licensing terms. Of course you have the right to do so. But I don't like that you removed the old files then.
>> 
>> I really, really want the text files back in the code base. Now.
>> 
>> I write documentation for every Asterisk user and want everyone that distributes Asterisk solutions to be able to distribute those files.
>> 
>> The wiki-only based distribution is a bad idea. It's a good compliment to other ways of distribution, but not a replacement of the original files.
>> /O
> 
> Olle
> 
> I understand your point of view.  
Thanks

> I work with many wiki support based
> systems.  A great example is http://wiki.snom.com and as you mentioned
> snom also allows the reconfiguration of the base directory.  If you
> want to change the base directory you can use a 302 redirect to the
> search page for the url terms.  These topics have been covered in many
> projects.  Lets get the documentation to a solid stable level on the
> wiki and then look at other options.  I would like to start adding
> some of the old docs to the wiki after I am done with updating
> Asterisk.

My opinion is to follow Kamailio where we have docbook XML docs in the code
and import them to the wiki. That way, there's alway a textbased README in the source code,
as well as the XML.

I don't like the docs to be in one central position, in a not very open format, in one single language and under a license that is a bit too restrictive for our community.

/O