Hello,
I installed a new wiki site, targeting to collect documentation for upcoming v3.2.0 and further releases. You can find it at:
* http://www.kamailio.org/wiki/
Hopefully, it will make the process of updating/migrating the relevant documentation from old wiki (http://www.kamailio.org/dokuwiki/) straightforward and offer a clean reference for upcoming stable version. Old wiki is in place since 2005, collected a lot of pages, but many are for very old versions of kamailio, making difficult, at least for new comers, to sort out documentation for latest stable.
All of you are invited to help with this process of adding documentation for 3.2.0 on the new wiki. The old wiki will stay in place, it will not be removed. Both are based on Dokuwiki, using different themes. The new one is at the beginning, so no much content in there yet, but by the time of releasing 3.2.0, should contain sufficient documentation for get started with that version.
One very demanded thing was the alphabetic index for parameters, functions and mi commands from modules. This page contains new generated indexes for version 3.2.0. More details in a separate email.
If you have questions about the new wiki, don't know where to place some tutorial, feel free to ask on mailing lists. Ultimately, pages can be relocated, but try to use namespaces for related topics.
Cheers, Daniel
El Mon, 03 Oct 2011 11:02:51 +0200 Daniel-Constantin Mierla miconda@gmail.com escribió:
Hello,
I installed a new wiki site, targeting to collect documentation for upcoming v3.2.0 and further releases. You can find it at:
Hopefully, it will make the process of updating/migrating the relevant documentation from old wiki (http://www.kamailio.org/dokuwiki/) straightforward and offer a clean reference for upcoming stable version. Old wiki is in place since 2005, collected a lot of pages, but many are for very old versions of kamailio, making difficult, at least for new comers, to sort out documentation for latest stable.
All of you are invited to help with this process of adding documentation for 3.2.0 on the new wiki. The old wiki will stay in place, it will not be removed. Both are based on Dokuwiki, using different themes. The new one is at the beginning, so no much content in there yet, but by the time of releasing 3.2.0, should contain sufficient documentation for get started with that version.
One very demanded thing was the alphabetic index for parameters, functions and mi commands from modules. This page contains new generated indexes for version 3.2.0. More details in a separate email.
If you have questions about the new wiki, don't know where to place some tutorial, feel free to ask on mailing lists. Ultimately, pages can be relocated, but try to use namespaces for related topics.
Cheers, Daniel
As suggestion, not related to the content, I'd change the theme. That red looks very agressive to me.
Hello,
On 10/3/11 11:09 AM, Jon Bonilla (Manwe) wrote:
El Mon, 03 Oct 2011 11:02:51 +0200 Daniel-Constantin Mierlamiconda@gmail.com escribió:
Hello,
I installed a new wiki site, targeting to collect documentation for upcoming v3.2.0 and further releases. You can find it at:
* http://www.kamailio.org/wiki/Hopefully, it will make the process of updating/migrating the relevant documentation from old wiki (http://www.kamailio.org/dokuwiki/) straightforward and offer a clean reference for upcoming stable version. Old wiki is in place since 2005, collected a lot of pages, but many are for very old versions of kamailio, making difficult, at least for new comers, to sort out documentation for latest stable.
All of you are invited to help with this process of adding documentation for 3.2.0 on the new wiki. The old wiki will stay in place, it will not be removed. Both are based on Dokuwiki, using different themes. The new one is at the beginning, so no much content in there yet, but by the time of releasing 3.2.0, should contain sufficient documentation for get started with that version.
One very demanded thing was the alphabetic index for parameters, functions and mi commands from modules. This page contains new generated indexes for version 3.2.0. More details in a separate email.
If you have questions about the new wiki, don't know where to place some tutorial, feel free to ask on mailing lists. Ultimately, pages can be relocated, but try to use namespaces for related topics.
Cheers, Daniel
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.
Cheers, Daniel
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. ;-) . 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?
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.
Best regards,
Henning
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 -
Henning Westerholt -
Jon Bonilla