June 2014 - freeswitch-docs@lists.freeswitch.org

[Freeswitch-docs] Opening discussion: Community
by Areski 30 Jun '14

30 Jun '14

Hi DocsTeam, I'm troubled by those 4 pages: - https://confluence.freeswitch.org/display/FREESWITCH/Community - https://confluence.freeswitch.org/display/FREESWITCH/Contributing - https://confluence.freeswitch.org/display/FREESWITCH/Developers - https://confluence.freeswitch.org/display/FREESWITCH/Reporting+Bugs especially by their current position in Confluence. I `personally` would like to see the following in the pagetree: Community + +----> Contributing (main page on contribute code/docs) | + | +-----> Reporting Bugs | | + | | +-----> Report issue checklist | | | +-----> Docs Team | | + | | +-----> all pages under Docs Team... | + | +-----> Bounty | | + | | +-----> Bounty list | | +-----> Bounty Completed | | | +-----> Using Git (merge Installing Git / Tips for using Git pages) | +----> MailingList | +----> IRC | +----> ClueCon Weekly Conference call | +----> ClueCon (new page to present Cluecon) Opinions / feedback / thoughts? -- Kind regards, /Areski ---- Arezqui Belaid, <areski(a)gmail.com> Founder at Star2Billing (www.star2billing.com) Tel: +34650784355 Twitter: http://twitter.com/areskib LinkedIn: http://www.linkedin.com/in/areski

6 38

Re: [Freeswitch-docs] Confluence reorder problem
by Bote Man 19 Jun '14

19 Jun '14

It might be a mechanical problem of dragging and dropping? I notice that Confluence is finicky about where you drop the page, but it will take the button-down event to start the drag WHEREVER your mouse is pointing on the page in a horizontal zone that is inline with the page title. Easy to make a mistake I found out, and there is no undo function for page moves. If you drop the moved page on top of an existing page name, the page will move to be a child of the existing page. Otherwise it simply places the page in between the two existing pages where you drop it. I haven't had a case where the page refused to move. My best guess is that there might be some special permission that only allows the page creator to move it, but I doubt that exists. I think the user database and therefore permissions are still in flux. Bote > -----Original Message----- > From: Mario G [mailto:mario_fs@mgtech.com] > Sent: Monday, 09 June, 2014 11:47 > To: Bote Man > Cc: William King; Brian West; Ken Rice > Subject: Re: Confluence reorder problem > > The OS X stuff is not moved, it moves in the reorder window but does > not save. No need to move now: I thought I was redoing the > installation since we talked about it a couple of times in meetings > about how I was going to split it up, I put it back, have at it. > > Also, I had a similar problem with reordering again, I tried to move > the original installation to where it was (above the Maintenance and > Configuration pages I created) and could not. However, I could move > those pages below the installation page. Something is amiss in > Confluence since some pages reorder and some do not, I moved lots of > pages around when I did Interoperability. > Mario > > On Jun 7, 2014, at 11:13 PM, Bote Man <bote_radio(a)botecomm.com> wrote: > > > I just opened the Old Installation tree, grabbed the Mac OS X parent > > page, and dragged it up and dropped it while hovering over > > "Installation" which is its new parent page. I'm running Firefox 28 > on > > Windows, FWIW. > > > > The 2 CentOS pages and Debian are up-to-date, if not fully > conformant to > > the Confluence standards that we have established; also SmartOS > under > > Virtualization. > > > > What's the plan here? I was going to tackle the Installation page by > > trimming it down to the basics: > > packages as first choice > > building from source or tarball if they insist. > > If you're handling the Installation tree then call me off so we > don't > > work at cross purposes. > > > > I got sidetracked with mod_rayo and friends today, anyway. > > > > Please advise. > > > > Also, wouldn't this be best discussed on the > > Freeswitch-docs(a)lists.freeswitch.org mailing list? That way other > docs > > team editors can benefit from our discovery. > > > > Go Giants! Go Athletics! > > > > Bote > > > > > > > > > >> -----Original Message----- > >> From: Mario G [mailto:mario_fs@mgtech.com] > >> Sent: Saturday, 07 June, 2014 18:19 > >> To: William King > >> Cc: Bote Man; Brian West; Ken Rice > >> Subject: Confluence reorder problem > >> > >> Not sure who can see what the issue is but thought you all should > know > >> about it. I started the wiki installation changes today. I barely > >> started and wanted to reorder pages, which I have done many times > >> before. But today I cannot reorder all pages, the Mac OS X section > >> under Installation (now Old Installation) won’t budge. I simply > wanted > >> to move completed sections from Old Installation to Installation, > it > >> won’t even move within Old Installation. Some will but Mac OS X > won’t > >> any ideas? I already spend 2 hours researching and trying different > >> things, we need to know when reader won’t work so as not to wast > time > >> and come up with a different plan. > >> Mario= > >

2 1

[Freeswitch-docs] Doc migration access
by Adolphe Cher-Aime 19 Jun '14

19 Jun '14

Good morning Ken, My my account acheraime is no longer able to access the confluence platform. Can you fix that for me? Thanks, -- *Adolphe CHER-AIME*

1 0

[Freeswitch-docs] Docs Team spreadsheet
by Bote Man 16 Jun '14

16 Jun '14

Upon further review: the Jira system does not seem well-suited to documentation tracking. I clicked Create and the details like CPU and operating system just get in the way, plus it does NOT have the fields and statuses that you mentioned. So I'm inclined to go with your spreadsheet. You have already done the work and it's already online and editable (hopefully only to members of the Docs Team!) so let's use that. !!==>> Just now I edited a field without being logged in, so anybody can edit that spreadsheet right now!! I made the Status field a list of choices so that it remains consistent throughout the table. I made Editing, Moved, and Complete. If it's blank it means the page has not been touched yet. If you accidentally enter a status, hit DELETE to erase that entry. This keeps the choices simple. Moved - means the page has simply been copied from the old wiki to Confluence, but still needs to be formatted according to the guidelines. Editing - means somebody is in the process of formatting and editing the page to ensure that the content describes the current Master code of FreeSWITCH. Complete - means the page is up to date. But remember: pages still must be edited as changes are made to FS code that must be documented. Thanks!! John Boteler Bote Communications Fort Lauderdale, FL From: Areski [mailto:areski@gmail.com] Sent: Tuesday, 10 June, 2014 12:30 To: Brian West Cc: Nguyễn Văn Nghĩa Em; Bote Man; Mario G; Ken Rice; William King; ycamargo(a)xmartek.com Subject: Re: FS Docs: wiki to Confluence move Hi Bote Man! I did a scrapping of the wiki and created a spreadsheet here, the spreadsheet is editable: https://docs.google.com/spreadsheets/d/1qsG-kRymvKlNBapnBLw86W130VdbnK6naYa… maybe this can be of some use? we could for instance start to work on a spreadsheet or use the spreadsheet (csv) to create tasks in bug tracker. * (there is 2858 pages in total)

2 15

Re: [Freeswitch-docs] Hello. I want to join freeswitch wiki.(Sorry, read this)
by Sungtae Kim 11 Jun '14

11 Jun '14

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hi, Here's my jira username. username : pchero On 2014? 06? 08? 08:27, William King wrote: > Please send requests to join the docs team to > freeswitch-docs(a)lists.freeswitch.org > > Also make sure to include your Jira username so your account can > have the permissions updated. > > William King wking(a)freeswitch.org FreeSWITCH Solutions, LLC PO BOX > 2531 Brookfield, WI 53008-2531 Twitter: @FreeSWITCH , @quentusrex > http://www.freeswitchbook.com http://www.freeswitchcookbook.com > > T: +1.213.286.0416 Skype:quentusrex > > On 06/06/2014 02:26 AM, Sungtae Kim wrote: >> Hello, >> >> I'm a CTI developer. And our company product use a Asterisk - >> Freeswitch. >> >> In the development time, I usually use a freeswitch wiki. And I >> got a lots of helps from freeswitch community. So, I want >> contribute something for community. >> >> Regards, Sungtae. >> > -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/ iQEcBAEBAgAGBQJTmAhTAAoJELJ5aiF4ugMqWOAH/idaZ7Y9SJQOnkKvEjQ3B6fM gOE8Hie5Wy5vnjTrWLt69bBJxBisgylvYt5yY4URltlLfRgcoyuDQwSiQm0Ud7U2 OnQ+v5fGnZQowsJDRUxoildTYshWrL1Z/4C4SMEfXfjRRRUkAcMvOEAi2JTQlQtJ aiYdOzbQkSdcTXCC8s/dNV1rvf+IKmuf+UDjFyk1KjZza85UukwTTdwk32JkXWK4 zSdRFc4NRbTsZTyubdKeD/ly7kL768dUqFlWt6cFLN/57iRjZwDynFDrcFSb1hdz nfQc7XlwZsMBmjrntz/7uM8nP/5x5wqiz8KVTF80sqtLOWX5so+AQYHjL+O9NpY= =r8HD -----END PGP SIGNATURE-----

1 0

[Freeswitch-docs] Documentation Jira, guidelines
by Bote Man 11 Jun '14

11 Jun '14

[ I'm moving this to the mailing list. The entire documentation team should be on the mailing list for these discussions, so please let BKW know if you are not on the list. Thanks. ] Welcome back to life! A) I think the Confluence permission matrix might still need some work. Ben Langfeld could not do anything the other day while logged in, he had to log out and post as anonymous in the blog comments at the bottom of the page for me to apply. B) BKW created a Jira for the Documentation project at https://jira.freeswitch.org/browse/DOCS Now, unlike a software project I considered the documentation to be self-documenting J For example, if a page is not formatted properly it is apparent to the eye. But with many people helping to move the wiki pages over perhaps we should use Jira to track the state of each Confluence page. I just want to avoid creating yet another database to maintain if it will not move the project forward. If it helps, then let's use it. Suggestions? C) That's quite a spreadsheet! I note a block of pages that are the FS Weekly which will not appear in Confluence. Also many pages for each channel variable. I think 2000+ pages is wayyyyyyyyyyyyyyyy too much, especially when many of the variable pages in old wiki consist of the basic template that was never filled out. Our objective is to make Confluence clean and concise, so if we can combine many small wiki pages into one useful Confluence page, that is a good goal. D) All pages need reformatting on Confluence I'm finding. Please follow the guidelines on https://confluence.freeswitch.org/display/FREESWITCH/Confluence+Wiki+Standa… >From your questions: 1) Some pages have been moved, but not tagged on the old wiki, this is true. Originally I put the wiki {{warning}} at the top with a pointer to the Confluence wiki, but later we chose the Category:Moved tag since it allows a list of moved pages to be created automatically on the old wiki. 2) There are many pages that should not be moved, I think. 3) There are some pages that were moved to Confluence at the beginning that do not follow the guidelines because we had not developed them yet, plus we did not know all the capabilities of Confluence. If anybody sees a page that needs attention, please correct it. 4) Special wiki pages can not be used, correct. Confluence has those built-in. 5) Confluence has many macros that are similar to the wiki special pages and template functions. This includes a Child Pages macro as seen on https://confluence.freeswitch.org/display/FREESWITCH/Modules The Confluence wiki is still a work in progress so we are keeping things "loose" while we discover the best practices to use. If anybody finds a better way to do something, please tell us on this mailing list so we all can benefit from it. Thanks! Bote From: Areski [mailto:areski@gmail.com] Sent: Tuesday, 10 June, 2014 12:30 To: Brian West Cc: Nguyễn Văn Nghĩa Em; Bote Man; Mario G; Ken Rice; William King; ycamargo(a)xmartek.com Subject: Re: FS Docs: wiki to Confluence move Hi Bote Man! Sorry to come back to live so late. I certainly missed everything that has been discussed on the topics, but if you still need help on moving documentation let me know, Ken just sorted my confluence access so I m ready to get started. My comments on few things, sorry in advance if some points sounds stupid or have been discussed already. What do you think if we put some tracking of the work in place, something like this: A) Define a list of all pages that need to be moved on Spreadsheet B) Push all `validated pages` to a bug tracker (maybe Jira) C) Define a workflow, ie: - Waiting (need to be moved), - Need content review - Review for Deletion (page we think we may want to delete) - Need reformatting (some page has been moved but the formatting is bad so we need to come back to them at some stage) - Need a menu - Solved D) Then let the folks picking the tasks they want I did a scrapping of the wiki and created a spreadsheet here, the spreadsheet is editable: https://docs.google.com/spreadsheets/d/1qsG-kRymvKlNBapnBLw86W130VdbnK6naYa… maybe this can be of some use? we could for instance start to work on a spreadsheet or use the spreadsheet (csv) to create tasks in bug tracker. * (there is 2858 pages in total) Few things I noted and on which I would appreciate some lights: 1) I see some pages that has been moved but not tagged on Secret-Wiki, ie <https://70.169.193.216/wiki/Installation_for_Windows> https://70.169.193.216/wiki/Installation_for_Windows - tag with "category:moved" Any special reasons why the tag is missing? 2) There is page we might not be willing to move, ie <https://70.169.193.216/wiki/Make_test> https://70.169.193.216/wiki/Make_test (maybe we can mark them on a bug tracker for review, waiting for deletion until a BDFL come along and take a decision) 3) This page doesn't use the menu correctly : <https://confluence.freeswitch.org/display/FREESWITCH/Configuring+FreeSWITCH> https://confluence.freeswitch.org/display/FREESWITCH/Configuring+FreeSWITCH We may want to try to use Table content correctly everywhere ( <https://confluence.atlassian.com/display/DOC/Table+of+Contents+Macro> https://confluence.atlassian.com/display/DOC/Table+of+Contents+Macro) there is no many pages where we do so, ie <https://confluence.freeswitch.org/display/FREESWITCH/Installation> https://confluence.freeswitch.org/display/FREESWITCH/Installation 4) I suppose the User page, Special pages and Talk pages don't need to be moved <http://wiki.freeswitch.org/wiki/User:Vmelachervu> http://wiki.freeswitch.org/wiki/User:Vmelachervu 5) Child pages mechanism seems something we may want to consider, see it here in action: <https://wiki.asterisk.org/wiki/display/AST/Asterisk+Command+Reference> https://wiki.asterisk.org/wiki/display/AST/Asterisk+Command+Reference Maybe something to consider?

1 0

[Freeswitch-docs] old wiki points to freeswit.ch
by Bote Man 06 Jun '14

06 Jun '14

The old wiki home page at https://wiki.freeswitch.org/wiki/Main_Page has the message pointing people to Confluence. Unfortunately, it's pointing to Brian's sandbox address of http://confluence.freeswit.ch/ So could Ken or somebody unlock it and edit that to point to https://confluence.freeswitch.org Thanks! Bote, the tired

1 0

[Freeswitch-docs] expand vs code macro
by Bote Man 05 Jun '14

05 Jun '14

A data point that I've observed: the code macro automatically treats its contents as "preformatted text" so all whitespace and newlines are preserved. The expand macro just formats text inside the macro the same outside the macro container. Confluence is weird about newline formatting. It hides markup which can be erased by putting the cursor at the start of a line, then hitting Backspace. It also treats newlines oddly when pasted in from other sources, which is what I suspect happened to Mario. I have not determined a reliable workaround yet. Bote > -----Original Message----- > From: Mario G [mailto:mario_fs@mgtech.com] > Sent: Saturday, 26 April, 2014 13:21 > To: Bote Man > Cc: William King; Brian West; Ken Rice > Subject: Re: Confluence next big issue - cannot attach files > > As I said use expand elsewhere. I am talking about a new bug I found > pasting text into the expand which should work the same a code but > does not: I said If I paste the code into the “code” macro > > > >> it works but the page is massive long. When I paste the exact same > >> clipboard into “expand” it has no newlines so the code is jammed > together. > > So something wrong about how expand handles newlines vs the code > macro. I had to play in MS word to get it to work but that is not good > since I don’t want to go through hoops every time I update. > > Logging out/in did not give me attach. Even with expand my text file > is 638 lines long. > Mario > > > On Apr 26, 2014, at 5:38 AM, Bote Man <bote_radio(a)botecomm.com> wrote: > > > Also, in case your browser remembers your login session, you should > log > > out, then log in again to pick up the additional group permissions > that > > William assigned yesterday. I just did and noticed a metric buttload > > more menu options available. > > > > Bote > > > > > >> -----Original Message----- > >> From: Mario G [mailto:mario_fs@mgtech.com] > >> Sent: Friday, 25 April, 2014 18:14 > >> To: William King > >> Cc: Brian West; Ken Rice; Bote Man > >> Subject: Re: Confluence next big issue - cannot attach files > >> > >> Forgot to mention.. Another BUG in Confluence…. I use the expand > macro > >> in places but cannot here: If I paste the code into the “code” > macro > >> it works but the page is massive long. When I paste the exact same > >> clipboard into “expand” it has no newlines so the code is jammed > >> together. I tried various things. Since the file is big attaching > it > >> made the most sense. But “attach” is not an option in tools…. Any > >> ideas? > >> Mario > >> > >> On Apr 25, 2014, at 2:10 PM, Mario G <mario_fs(a)mgtech.com> wrote: > >> > >>> I am working on the Applescript page today (see my space), my plan > >> was to attach the script as a file since it is a couple of hundred > >> lines and will get longer as I add update capability. I wanted the > >> viewer to simply click download. But I see I do not have the > ability > >> to attach files. Is this by design? If so I need to know how I can > >> attach a large file to a page that I can replace//update as needed. > >>> > >>> Please let me know soon as I am stuck with this page and need to > >> know how to handle this. Thanks, > >>> Mario > >

1 0

[Freeswitch-docs] Docs Meeting today 2PM Central 888
by Brian West 03 Jun '14

03 Jun '14

If you can't attend please let me know a better time so we can possibly have more calls at different times. -- Brian West brian(a)freeswitch.org Twitter: @FreeSWITCH , @briankwest http://www.freeswitchbook.com http://www.freeswitchcookbook.com T: +1.918.420.9001 | F: +1.918.420.9002 | M: +1.918.424.WEST iNUM: +883 5100 1420 9001 ISN: 410*543 Skype:briankwest PGP Key: http://www.bkw.org/key.txt (AB93356707C76CED)

1 0

[Freeswitch-docs] Confluence blog comments
by Bote Man 02 Jun '14

02 Jun '14

William or Ken: The other night NYSolutions had some updates for the Debian installation instructions, but he mentioned that he could not do anything with Confluence while still logged in with his Jira credentials. He was forced to post a comment (at the bottom) as Anonymous. I don't know if you're still in the midst of the whole single sign-on mish-mash, but in case there are more permissions to be set this should be examined. Also, Confluence must be acting weird because it gives me an "edit permissions" button, but then won't let me use it because I don't have permissions. And now it has removed about half the menu choices from that Space Tools popup menu down in the lower left. Curious. Thanks. Bote

1 0