Sergey Okhapkin
2005-Oct-20 04:50 UTC
[Asterisk-Users] Why Asterisk documentation is so poor...
http://bugs.digium.com/view.php?id=5472 The users will not learn about undocumented AEL features. Sure I'm not going to reopen the problem.
Olle E. Johansson
2005-Oct-20 06:50 UTC
[Asterisk-Users] Why Asterisk documentation is so poor...
Sergey Okhapkin wrote:> http://bugs.digium.com/view.php?id=5472 > > The users will not learn about undocumented AEL features. Sure I'm not > going to reopen the problem.Sergey, I am sorry if you took our comments that badly. I proposed a worthing and you did not accept that and refused to update according to our suggestions. Tilghman therefor decided to close the bug. I suggest you try again, re-open the bug, fix the problem and continue to add more documentation. We do need more documentation! It has to be correct though, and that's why we are giving feedback. /Olle
Someone wrote me off list:> I would like to be able to help, but I'm not a C programmer - is there > any other way I can assist the project? >There are many ways! Testing new patches, making sure they are documented properly, that they work as expected. Making sure the Wiki is up to date with 1.2. Start with browsing through all [post 1.2] patches in the bug tracker, testing and making comments. We need both positive feedback (Yes, this works for me as well) and negative feedback (Hey, this did not work on my Commodore Amiga with a 300 baud modem!). There are a ton of post 1.2 patches in the bug tracker. Any help with making sure that they all work, that the code follow the bug guidelines and that they are well documented both within the code, in README files and within sample configuration files is appreciated. Core developers and bug marshals has been focusing on getting 1.2 out and still are, so those bugs have been put aside in "no-music-but-still-on-hold mode". A lot of this can be done by non-programmers and will greatly help us moving forward with 1.3 after the release of 1.2. Join us in #asterisk-dev or #asterisk-bugs on IRC if you have any questions. Welcome to the Asterisk development community that involves coders, testers and documentation writers! /Olle PS. And if you want a good example of a development community member that do not code you can search the mailing lists for John Todd - he's continuosly sending in good proposals, ideas, testing stuff, giving feedback - but promptly refuses to learn how to code and fix it himself...
On Sat, 2005-10-22 at 11:28 +0200, Olle E. Johansson wrote:> A lot of this can be done by non-programmers and will greatly help us > moving forward with 1.3 after the release of 1.2. Join us in > #asterisk-dev or #asterisk-bugs on IRC if you have any questions.you may want to mention that this is irc.freenode.net to avoid confusing it with the thousands of other irc networks :) -- Trixter http://www.0xdecafbad.com Bret McDanel UK +44 870 340 4605 Germany +49 801 777 555 3402 US +1 360 207 0479 or +1 516 687 5200 FreeWorldDialup: 635378 -------------- next part -------------- A non-text attachment was scrubbed... Name: not available Type: application/pgp-signature Size: 189 bytes Desc: This is a digitally signed message part Url : http://lists.digium.com/pipermail/asterisk-users/attachments/20051022/d5cd652d/attachment.pgp