<div dir="ltr"><div>Thanks for the feedback, I will be able to progress with what I got so far.</div><div><br></div><div>I dont have delete permission on pages, could you remove this one : <a href="https://confluence.freeswitch.org/display/FREESWITCH/Script+Languages">https://confluence.freeswitch.org/display/FREESWITCH/Script+Languages</a><br>
</div><div>We will keep this one that was already created.</div><div><br></div><div>Confluence is really a huge step forward from the previous wiki. I played a bit with moving page, it's magic.</div><div><br></div><div>
If there is a problem with the spreadsheet let me know, so far I haven't see anyone editing it!</div><div><br></div><div><br></div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Thu, Jun 12, 2014 at 9:43 PM, Bote Man <span dir="ltr"><<a href="mailto:bote_radio@botecomm.com" target="_blank">bote_radio@botecomm.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div lang="EN-US" link="blue" vlink="purple"><div><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">A-HA! You have discovered the downfall of the wiki: it is too easy for people to create many pages without regard for what already exists. This is why we want to organize the Confluence wiki to make it easier to find things and create order out of chaos </span><span style="font-size:11.0pt;font-family:Wingdings;color:black">J</span><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"><u></u><u></u></span></p>
<div class=""><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"><u></u> <u></u></span></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">"</span><i>I created this page:<u></u><u></u></i></p>
<p class="MsoNormal"><i><a href="https://confluence.freeswitch.org/display/FREESWITCH/Which+scripting+language+should+I+use" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/Which+scripting+language+should+I+use</a><u></u><u></u></i></p>
<p class="MsoNormal"><i>and the parent is "FreeSWITCH explained", now this page appear in the left menu. <u></u><u></u></i></p><p class="MsoNormal"><i>How can I avoid that ?</i>"<u></u><u></u></p><p class="MsoNormal">
<span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"><u></u> <u></u></span></p></div><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">Whenever you click the CREATE button at the top of Confluence, the new page becomes a child of the current page. So if you are currently viewing the top level page "FreeSWITCH Explained" the new page will be created under that and so will appear as a top-level outline heading.<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"><u></u> <u></u></span></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">I think it is best to change the title of that page (and pages like it) to a simple "Scripting" or "Script Languages", discuss the choices, then post pages specific to each script language as children of that page.<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"><u></u> <u></u></span></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">As a user, I prefer one long page on a topic as opposed to a bunch a smaller pages that I must hunt down to find. I can always hit Ctrl-F and search for text inside a long page to find it quickly. Using the search engine of the host site is always guess-work.<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"><u></u> <u></u></span></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">I also have been persuaded by smarter people that FAQ are evil. Instead of guessing the questions and trying to answer them, let's just explain the topic clearly and add or edit as questions arise on the mailing list and IRC channel. The documentation should always match the current Master version of code, the latest on offer.<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"><u></u> <u></u></span></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">I have confidence that you will handle the Lua pages well. I do not know Lua so if you do, then feel free to organize it the best way. I think it is nicer to have one page discussing, for example, Lua database handling instead of multiple pages, but if you think that would make the pages too complicated then go ahead and split them out. Certainly, combine the many old wiki pages the best way that you can find. <u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"><u></u> <u></u></span></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">Right after I copy a page from the old wiki to Confluence, I then make obvious edits like setting the proper heading levels. This is for both readability and to help screen readers interpret sections of the page for those with poor eye sight.<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"><u></u> <u></u></span></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">The good thing is that Confluence allows us to move pages at any time so if you find that a page must be moved, go to Reorder Pages, expand the tree, grab the page with your mouse, and drag it to the new location. Release the page on top of an existing page to move it to a child of that page, move it between existing pages to move it in between them at the same outline level.<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"><u></u> <u></u></span></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">Thanks!!<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"><u></u> <u></u></span></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">Bote<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"><u></u> <u></u></span></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"><u></u> <u></u></span></p>
<div style="border:none;border-left:solid blue 1.5pt;padding:0in 0in 0in 4.0pt"><div><div style="border:none;border-top:solid #b5c4df 1.0pt;padding:3.0pt 0in 0in 0in"><p class="MsoNormal"><b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif"">From:</span></b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif""> Areski [mailto:<a href="mailto:areski@gmail.com" target="_blank">areski@gmail.com</a>] <br>
<b>Sent:</b> Thursday, 12 June, 2014 11:51</span></p><div><div class="h5"><br><b>To:</b> Bote Man<br><b>Cc:</b> <a href="mailto:Freeswitch-docs@lists.freeswitch.org" target="_blank">Freeswitch-docs@lists.freeswitch.org</a><br>
<b>Subject:</b> Re: Docs Team spreadsheet<u></u><u></u></div></div><p></p></div></div><div><div class="h5"><p class="MsoNormal"><u></u> <u></u></p><div><p class="MsoNormal">Hi Bote & Co, <u></u><u></u></p><div><p class="MsoNormal">
<u></u> <u></u></p><div><p class="MsoNormal">I moved few pages today and got my hands comfortable with Confluence.<u></u><u></u></p></div><div><p class="MsoNormal"><u></u> <u></u></p></div><div><p class="MsoNormal">I created this page:<u></u><u></u></p>
</div><div><p class="MsoNormal"><a href="https://confluence.freeswitch.org/display/FREESWITCH/Which+scripting+language+should+I+use" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/Which+scripting+language+should+I+use</a><u></u><u></u></p>
</div><div><p class="MsoNormal">and the parent is "FreeSWITCH explained", now this page appear in the left menu. <u></u><u></u></p></div><div><p class="MsoNormal">How can I avoid that ?<u></u><u></u></p></div><div>
<p class="MsoNormal"><u></u> <u></u></p></div><div><p class="MsoNormal">I reformatted mod_lua page (a topic I know well), <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua</a><u></u><u></u></p>
</div><div><p class="MsoNormal">This page is very long,,, very long, plus there is 19 pages about Lua in total, which are quite disorganized.<u></u><u></u></p></div><div><p class="MsoNormal"><u></u> <u></u></p></div><div>
<div><p class="MsoNormal">Existing pages related to Lua<u></u><u></u></p></div><div><p class="MsoNormal"><a href="https://wiki.freeswitch.org/wiki/Mod_lua" target="_blank">https://wiki.freeswitch.org/wiki/Mod_lua</a><u></u><u></u></p>
</div><div><p class="MsoNormal"><a href="https://wiki.freeswitch.org/wiki/Mod_lua/Example_dialplan" target="_blank">https://wiki.freeswitch.org/wiki/Mod_lua/Example_dialplan</a><u></u><u></u></p></div><div><p class="MsoNormal">
<a href="https://wiki.freeswitch.org/wiki/Mod_lua/Serving_Configuration" target="_blank">https://wiki.freeswitch.org/wiki/Mod_lua/Serving_Configuration</a><u></u><u></u></p></div><div><p class="MsoNormal"><a href="https://wiki.freeswitch.org/wiki/Mod_lua/Examples/Extra" target="_blank">https://wiki.freeswitch.org/wiki/Mod_lua/Examples/Extra</a><u></u><u></u></p>
</div><div><p class="MsoNormal"><a href="https://wiki.freeswitch.org/wiki/Installing_LuaSQL" target="_blank">https://wiki.freeswitch.org/wiki/Installing_LuaSQL</a><u></u><u></u></p></div><div><p class="MsoNormal"><a href="https://wiki.freeswitch.org/wiki/IVR" target="_blank">https://wiki.freeswitch.org/wiki/IVR</a><u></u><u></u></p>
</div><div><p class="MsoNormal"><a href="https://wiki.freeswitch.org/wiki/Lua_MythTV_alert_example" target="_blank">https://wiki.freeswitch.org/wiki/Lua_MythTV_alert_example</a><u></u><u></u></p></div><div><p class="MsoNormal">
<a href="https://wiki.freeswitch.org/wiki/Fakecall_responder" target="_blank">https://wiki.freeswitch.org/wiki/Fakecall_responder</a><u></u><u></u></p></div><div><p class="MsoNormal"><a href="https://wiki.freeswitch.org/wiki/Call_retry_based_on_hangup_cause" target="_blank">https://wiki.freeswitch.org/wiki/Call_retry_based_on_hangup_cause</a><u></u><u></u></p>
</div><div><p class="MsoNormal"><a href="https://wiki.freeswitch.org/wiki/Bridging_two_calls_with_retry" target="_blank">https://wiki.freeswitch.org/wiki/Bridging_two_calls_with_retry</a><u></u><u></u></p></div><div><p class="MsoNormal">
<a href="https://wiki.freeswitch.org/wiki/Lua_Intercom" target="_blank">https://wiki.freeswitch.org/wiki/Lua_Intercom</a><u></u><u></u></p></div><div><p class="MsoNormal"><a href="https://wiki.freeswitch.org/wiki/Lua_freeswitch_dbh" target="_blank">https://wiki.freeswitch.org/wiki/Lua_freeswitch_dbh</a><u></u><u></u></p>
</div><div><p class="MsoNormal"><a href="https://wiki.freeswitch.org/wiki/Lua_Welcome_IVR_Example" target="_blank">https://wiki.freeswitch.org/wiki/Lua_Welcome_IVR_Example</a><u></u><u></u></p></div><div><p class="MsoNormal">
<a href="https://wiki.freeswitch.org/wiki/Examples_db_agent_login_lua" target="_blank">https://wiki.freeswitch.org/wiki/Examples_db_agent_login_lua</a><u></u><u></u></p></div><div><p class="MsoNormal"><a href="https://wiki.freeswitch.org/wiki/Make_API_calls_directly_from_Lua_code" target="_blank">https://wiki.freeswitch.org/wiki/Make_API_calls_directly_from_Lua_code</a><u></u><u></u></p>
</div><div><p class="MsoNormal"><a href="https://wiki.freeswitch.org/wiki/Examples_directory_lua_asr_tts" target="_blank">https://wiki.freeswitch.org/wiki/Examples_directory_lua_asr_tts</a><u></u><u></u></p></div><div><p class="MsoNormal">
<a href="https://wiki.freeswitch.org/wiki/Examples_directory_lua" target="_blank">https://wiki.freeswitch.org/wiki/Examples_directory_lua</a><u></u><u></u></p></div><div><p class="MsoNormal"><a href="https://wiki.freeswitch.org/wiki/Lua_Examples" target="_blank">https://wiki.freeswitch.org/wiki/Lua_Examples</a><u></u><u></u></p>
</div><div><p class="MsoNormal"><a href="https://wiki.freeswitch.org/wiki/Category:Lua" target="_blank">https://wiki.freeswitch.org/wiki/Category:Lua</a><u></u><u></u></p></div><div><p class="MsoNormal"><u></u> <u></u></p>
</div><div><p class="MsoNormal"><u></u> <u></u></p></div><div><p class="MsoNormal">I would like to propose a new structure on Confluence:<u></u><u></u></p></div><div><p class="MsoNormal"><u></u> <u></u></p></div><div><p class="MsoNormal">
First split and change the mod_lua page.<u></u><u></u></p></div><div><p class="MsoNormal">0) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua</a><u></u><u></u></p>
</div><div><p class="MsoNormal"> -> Remove API & FAQ (they will have their own pages)<u></u><u></u></p></div><div><p class="MsoNormal"> -> Point to API, Serving Configuration, Lua with Database, FAQ, Examples<u></u><u></u></p>
</div><div><p class="MsoNormal"><u></u> <u></u></p></div><div><div><p class="MsoNormal">The rest of the pages will be child pages under Mod_lua:<u></u><u></u></p></div><div><p class="MsoNormal">1) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/API" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/API</a><u></u><u></u></p>
</div><div><p class="MsoNormal">2) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Serving_Configuration" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Serving_Configuration</a><u></u><u></u></p>
</div><div><p class="MsoNormal">3) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Database" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Database</a><u></u><u></u></p>
</div><div><p class="MsoNormal"> -> this page will list the child pages<u></u><u></u></p></div><div><p class="MsoNormal"> 3.1) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Database/DBH" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Database/DBH</a><u></u><u></u></p>
</div><div><p class="MsoNormal"> 3.2) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Database/LuaSQL" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Database/LuaSQL</a><u></u><u></u></p>
</div><div><p class="MsoNormal">4) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/FAQ" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/FAQ</a><u></u><u></u></p></div><div>
<p class="MsoNormal">5) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples</a><u></u><u></u></p></div><div>
<p class="MsoNormal"> -> this page will list the child pages<u></u><u></u></p></div><div><p class="MsoNormal"> 5.1) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/</a><u></u><u></u></p>
</div><div><p class="MsoNormal"> 5.2) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/Dialplan" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/Dialplan</a><u></u><u></u></p>
</div><div><p class="MsoNormal"> 5.3) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/IVR" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/IVR</a><u></u><u></u></p>
</div><div><p class="MsoNormal"> -> Previous IVR page (<a href="https://wiki.freeswitch.org/wiki/IVR" target="_blank">https://wiki.freeswitch.org/wiki/IVR</a>) merged with Lua_Welcome_IVR_Example<u></u><u></u></p>
</div><div><p class="MsoNormal"> 5.4) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/Extra" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/Extra</a><u></u><u></u></p>
</div><div><p class="MsoNormal"> -> this page will list the child pages<u></u><u></u></p></div><div><p class="MsoNormal"> 5.5) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/Extra/Bridging_two_calls_with_retry" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/Extra/Bridging_two_calls_with_retry</a><u></u><u></u></p>
</div><div><p class="MsoNormal"> 5.6) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/Extra/Fakecall_Responder" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/Extra/Fakecall_Responder</a><u></u><u></u></p>
</div><div><p class="MsoNormal"> 5.7) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/Extra/MythTV_alert" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/Extra/MythTV_alert</a><u></u><u></u></p>
</div><div><p class="MsoNormal"> 5.8) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/Extra/Intercom" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/Extra/Intercom</a><u></u><u></u></p>
</div><div><p class="MsoNormal"> 5.9) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/Extra/Agent_login" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/Extra/Agent_login</a><u></u><u></u></p>
</div><div><p class="MsoNormal"> 5.10) <a href="https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/Extra/Directory" target="_blank">https://confluence.freeswitch.org/display/FREESWITCH/mod_lua/Examples/Extra/Directory</a><u></u><u></u></p>
</div><div><p class="MsoNormal"> -> merge Examples_directory_lua_asr_tts and Examples_directory_lua<u></u><u></u></p></div><div><p class="MsoNormal"><u></u> <u></u></p></div><div><p class="MsoNormal">Note: <u></u><u></u></p>
</div><div><p class="MsoNormal">Those 3 pages will be deleted:<u></u><u></u></p></div><div><div><p class="MsoNormal">- <a href="https://wiki.freeswitch.org/wiki/Lua_Examples" target="_blank">https://wiki.freeswitch.org/wiki/Lua_Examples</a><u></u><u></u></p>
</div><div><p class="MsoNormal">- <a href="https://wiki.freeswitch.org/wiki/Category:Lua" target="_blank">https://wiki.freeswitch.org/wiki/Category:Lua</a><u></u><u></u></p></div></div><div><p class="MsoNormal">- <a href="https://wiki.freeswitch.org/wiki/Call_retry_based_on_hangup_cause" target="_blank">https://wiki.freeswitch.org/wiki/Call_retry_based_on_hangup_cause</a><u></u><u></u></p>
</div><div><p class="MsoNormal"> -> This page will be deleted but the example reused inside the mod_lua/API page<u></u><u></u></p></div><div><p class="MsoNormal"><u></u> <u></u></p></div><div><p class="MsoNormal">Extra:<u></u><u></u></p>
</div><div><p class="MsoNormal">On a 2nd phase, we should put some effort in rewriting some part of mod_lua pages<u></u><u></u></p></div><div><p class="MsoNormal">-> Reorder the topics that need to be covered by priority<u></u><u></u></p>
</div><div><p class="MsoNormal">-> Ensure that examples are simple enough and point to more complex ones<u></u><u></u></p></div></div></div><div><p class="MsoNormal"><u></u> <u></u></p></div><div><p class="MsoNormal">
<u></u> <u></u></p>
</div><div><p class="MsoNormal">I would appreciate comments / thoughts?<u></u><u></u></p></div><div><p class="MsoNormal"><u></u> <u></u></p></div></div></div><div><p class="MsoNormal" style="margin-bottom:12.0pt"><u></u> <u></u></p>
<div><p class="MsoNormal">On Thu, Jun 12, 2014 at 12:56 AM, Areski <<a href="mailto:areski@gmail.com" target="_blank">areski@gmail.com</a>> wrote:<u></u><u></u></p><div><div><p class="MsoNormal">> <span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">But this documentation project is like a Navy ship: if you see a job that you can do, then do it! </span><span style="font-size:11.0pt;font-family:Wingdings;color:black">J</span><u></u><u></u></p>
</div><div><p class="MsoNormal">I would agree, but there is certainly peoples willing to help which needs clear instruction of what they can do. <u></u><u></u></p></div><div><p class="MsoNormal">If we don't see clearly what is remaining, there is a risk of being discouraged.<u></u><u></u></p>
</div><div><p class="MsoNormal"><u></u> <u></u></p></div><div><p class="MsoNormal">On an extra note: <u></u><u></u></p></div><div><p class="MsoNormal">After scrapying the actual Wiki, I had a bunch of data about the pages, I thought it could be fun to try to display all the wiki page-relations on a graph to see what the big monster have in his stomach (a very weird idea)<u></u><u></u></p>
</div><div><p class="MsoNormal"><a href="http://dl.dropboxusercontent.com/u/6076501/d3-wiki/index_all.html" target="_blank">http://dl.dropboxusercontent.com/u/6076501/d3-wiki/index_all.html</a><u></u><u></u></p></div><div>
<p class="MsoNormal">It's a huge canvas so you need to zoom out in order to see something, well it's a bit pointless it's just too much data to see anything.<u></u><u></u></p></div><div><p class="MsoNormal">I was hoping it will show how the wiki is actually organized, but apart from seeing the leaf-pages, this doesn't have much value :/<u></u><u></u></p>
</div><div><p class="MsoNormal"><u></u> <u></u></p></div><div><p class="MsoNormal">The dataset here if someone is interested: <a href="https://dl.dropboxusercontent.com/u/6076501/d3-wiki/wikidataset.json" target="_blank">https://dl.dropboxusercontent.com/u/6076501/d3-wiki/wikidataset.json</a><u></u><u></u></p>
</div><div><p class="MsoNormal"><u></u> <u></u></p></div></div><div><div><div><p class="MsoNormal" style="margin-bottom:12.0pt"><u></u> <u></u></p><div><p class="MsoNormal">On Wed, Jun 11, 2014 at 7:03 PM, Bote Man <<a href="mailto:bote_radio@botecomm.com" target="_blank">bote_radio@botecomm.com</a>> wrote:<u></u><u></u></p>
<div><div><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">I don't know. Perhaps the "Edited by" field should only show the last person who worked on the page? But this requires manual entry and it's easy to forget to add that information to the spreadsheet.</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">I assume that if somebody marks the page "Complete" then that person's name should appear.</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">But this documentation project is like a Navy ship: if you see a job that you can do, then do it! </span><span style="font-size:11.0pt;font-family:Wingdings;color:black">J</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">Bote</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p>
<div style="border:none;border-left:solid blue 1.5pt;padding:0in 0in 0in 4.0pt"><div><div style="border:none;border-top:solid #b5c4df 1.0pt;padding:3.0pt 0in 0in 0in"><p class="MsoNormal"><b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif"">From:</span></b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif""> Areski [mailto:<a href="mailto:areski@gmail.com" target="_blank">areski@gmail.com</a>] <br>
<b>Sent:</b> Wednesday, 11 June, 2014 10:49</span><u></u><u></u></p><div><p class="MsoNormal"><br><b>To:</b> Bote Man<br><b>Cc:</b> <a href="mailto:Freeswitch-docs@lists.freeswitch.org" target="_blank">Freeswitch-docs@lists.freeswitch.org</a><br>
<b>Subject:</b> Re: Docs Team spreadsheet<u></u><u></u></p></div></div></div><p class="MsoNormal"> <u></u><u></u></p><div><p class="MsoNormal">Hi John,<u></u><u></u></p><div><div><div><p class="MsoNormal"> <u></u><u></u></p>
</div><div><p class="MsoNormal">I'm tempted to add `reviewed by` column next to `assigned`, <u></u><u></u></p></div><div><p class="MsoNormal">so that each completed page got also an extra person to review it. <u></u><u></u></p>
</div><div><p class="MsoNormal">Thoughts ? will it be too much work?<u></u><u></u></p></div><div><p class="MsoNormal"> <u></u><u></u></p></div><div><p class="MsoNormal">The spreadsheet is down to 1437 pages, my scrapying techniques generated duplicate.<u></u><u></u></p>
</div><div><p class="MsoNormal"><a href="https://docs.google.com/spreadsheets/d/1qsG-kRymvKlNBapnBLw86W130VdbnK6naYapbR_UNds/edit#gid=1187898333" target="_blank">https://docs.google.com/spreadsheets/d/1qsG-kRymvKlNBapnBLw86W130VdbnK6naYapbR_UNds/edit#gid=1187898333</a><u></u><u></u></p>
</div><div><p class="MsoNormal">It's also a bit cleaner now.<u></u><u></u></p></div><div><p class="MsoNormal"> <u></u><u></u></p></div><div><p class="MsoNormal"> <u></u><u></u></p></div></div></div></div><div><div><div>
<p class="MsoNormal" style="margin-bottom:12.0pt"> <u></u><u></u></p><div><p class="MsoNormal">On Wed, Jun 11, 2014 at 12:41 PM, Areski <<a href="mailto:areski@gmail.com" target="_blank">areski@gmail.com</a>> wrote:<u></u><u></u></p>
<div><p class="MsoNormal">Hi John,<u></u><u></u></p><div><p class="MsoNormal"> <u></u><u></u></p></div><div><p class="MsoNormal">Thanks for the inputs.<u></u><u></u></p></div><div><p class="MsoNormal"> <u></u><u></u></p>
</div>
<div><p class="MsoNormal">There is some advantages in using a bug tracker for controlling the doc conversion, especially if we want to do a bit more than just copying pages,<u></u><u></u></p></div><div><p class="MsoNormal">
I understand we need to be pragmatic, so I would agree on using a spreadsheet for now and maybe at later stage consider an issue-tracker, there is plenty tools out there that could allow us to have enough customization for what we need.<u></u><u></u></p>
</div><div><div><p class="MsoNormal"> <u></u><u></u></p></div><div><p class="MsoNormal"><br><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">> !!==>> Just now I edited a field without being logged in, so anybody can edit that spreadsheet right now!!</span><u></u><u></u></p>
</div></div><div><p class="MsoNormal">Not the case anymore, I removed public edition of the spreadsheet and added the edit permission only for the peoples I know are working on this. Any of you can now add extra editors to this document, this is something we need to do on request.<u></u><u></u></p>
</div><div><p class="MsoNormal"> <u></u><u></u></p></div><div><p class="MsoNormal">I added 2 extra status:<u></u><u></u></p></div><div><p class="MsoNormal"> 1) Pending - <span style="font-size:10.0pt;font-family:"Arial","sans-serif"">means the page has not been looked at yet (all pages are marked as pending now)</span><u></u><u></u></p>
</div><div><p class="MsoNormal"><span style="font-size:10.0pt;font-family:"Arial","sans-serif""> This will have some advantages if we want to filter the pending tasks on an other sheets or document.</span><u></u><u></u></p>
</div><div><p class="MsoNormal"><span style="font-size:10.0pt;font-family:"Arial","sans-serif""> </span><u></u><u></u></p></div><div><p class="MsoNormal"><span style="font-size:10.0pt;font-family:"Arial","sans-serif""> 2) Delete -<span style="color:black"> means the page doesn't need to be converted, ie this page for example (</span></span><span style="font-family:"Arial","sans-serif";color:black"><a href="http://wiki.freeswitch.org/wiki/Help:Contents" target="_blank">http://wiki.freeswitch.org/wiki/Help:Contents</a>)</span><u></u><u></u></p>
</div><div><div><p class="MsoNormal"> <u></u><u></u></p></div><div><p class="MsoNormal"> <u></u><u></u></p></div><div><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">> But remember: pages still must be edited as changes are made to FS code that must be documented.</span><u></u><u></u></p>
</div></div><div><p class="MsoNormal">I suppose we can try sooner to push good practice here, and invite peoples in opening Jira docs ticket for new pages that have content not up to date, which require good experienced fs-dev to look at it.<u></u><u></u></p>
</div><div><p class="MsoNormal"> <u></u><u></u></p></div><div><p class="MsoNormal"> <u></u><u></u></p></div><div><p class="MsoNormal"> <u></u><u></u></p></div><div><p class="MsoNormal"> <u></u><u></u></p></div></div><div>
<div><div><p class="MsoNormal" style="margin-bottom:12.0pt"> <u></u><u></u></p><div><p class="MsoNormal">On Wed, Jun 11, 2014 at 3:39 AM, Bote Man <<a href="mailto:bote_radio@botecomm.com" target="_blank">bote_radio@botecomm.com</a>> wrote:<u></u><u></u></p>
<div><div><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">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.</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">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. </span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">!!==>> Just now I edited a field without being logged in, so anybody can edit that spreadsheet right now!!</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">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.</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">Moved - means the page has simply been copied from the old wiki to Confluence, but still needs to be formatted according to the guidelines.</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">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.</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">Complete - means the page is up to date.</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">But remember: pages still must be edited as changes are made to FS code that must be documented.</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">Thanks!!</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">John Boteler</span><u></u><u></u></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">Bote Communications</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black">Fort Lauderdale, FL</span><u></u><u></u></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p><p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:black"> </span><u></u><u></u></p><div style="border:none;border-left:solid blue 1.5pt;padding:0in 0in 0in 4.0pt">
<div><div style="border:none;border-top:solid #b5c4df 1.0pt;padding:3.0pt 0in 0in 0in"><p class="MsoNormal"><b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif"">From:</span></b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif""> Areski [mailto:<a href="mailto:areski@gmail.com" target="_blank">areski@gmail.com</a>] <br>
<b>Sent:</b> Tuesday, 10 June, 2014 12:30<br><b>To:</b> Brian West<br><b>Cc:</b> Nguyễn Văn Nghĩa Em; Bote Man; Mario G; Ken Rice; William King; <a href="mailto:ycamargo@xmartek.com" target="_blank">ycamargo@xmartek.com</a><br>
<b>Subject:</b> Re: FS Docs: wiki to Confluence move</span><u></u><u></u></p></div></div><p class="MsoNormal"> <u></u><u></u></p><div><p class="MsoNormal">Hi Bote Man!<u></u><u></u></p><div><p class="MsoNormal"> <u></u><u></u></p>
</div><div><p class="MsoNormal"> <u></u><u></u></p></div><div><p class="MsoNormal">I did a scrapping of the wiki and created a spreadsheet here, the spreadsheet is editable:<u></u><u></u></p></div><div><p class="MsoNormal">
<a href="https://docs.google.com/spreadsheets/d/1qsG-kRymvKlNBapnBLw86W130VdbnK6naYapbR_UNds/edit#gid=1187898333" target="_blank">https://docs.google.com/spreadsheets/d/1qsG-kRymvKlNBapnBLw86W130VdbnK6naYapbR_UNds/edit#gid=1187898333</a><u></u><u></u></p>
</div><div><p class="MsoNormal">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.<u></u><u></u></p></div><div><p class="MsoNormal">
* (there is 2858 pages in total)<u></u><u></u></p></div><div><p class="MsoNormal"> <u></u><u></u></p></div><div><p class="MsoNormal"> <u></u><u></u></p></div></div></div></div></div></div><p class="MsoNormal"><br><br clear="all">
<u></u><u></u></p><div><p class="MsoNormal"> <u></u><u></u></p></div></div></div><p class="MsoNormal"><span style="color:#888888">-- <br>Kind regards,<br>/Areski<br><br>----<br>Arezqui Belaid, <<a href="mailto:areski@gmail.com" target="_blank">areski@gmail.com</a>><br>
Founder at Star2Billing (<a href="http://www.star2billing.com" target="_blank">www.star2billing.com</a>)<br><br>Tel: <a href="tel:%2B34650784355" target="_blank">+34650784355</a><br>Twitter: <a href="http://twitter.com/areskib" target="_blank">http://twitter.com/areskib</a> <br>
LinkedIn: <a href="http://www.linkedin.com/in/areski" target="_blank">http://www.linkedin.com/in/areski</a> </span><u></u><u></u></p></div></div><p class="MsoNormal"><br><br clear="all"><u></u><u></u></p><div><p class="MsoNormal">
<u></u><u></u></p></div><p class="MsoNormal">-- <br>Kind regards,<br>/Areski<br><br>----<br>Arezqui Belaid, <<a href="mailto:areski@gmail.com" target="_blank">areski@gmail.com</a>><br>Founder at Star2Billing (<a href="http://www.star2billing.com" target="_blank">www.star2billing.com</a>)<br>
<br>Tel: <a href="tel:%2B34650784355" target="_blank">+34650784355</a><br>Twitter: <a href="http://twitter.com/areskib" target="_blank">http://twitter.com/areskib</a> <br>LinkedIn: <a href="http://www.linkedin.com/in/areski" target="_blank">http://www.linkedin.com/in/areski</a> <u></u><u></u></p>
</div></div></div></div></div></div></div><p class="MsoNormal"><br><br clear="all"><u></u><u></u></p><div><p class="MsoNormal"><u></u> <u></u></p></div><p class="MsoNormal">-- <br>Kind regards,<br>/Areski<br><br>----<br>
Arezqui Belaid, <<a href="mailto:areski@gmail.com" target="_blank">areski@gmail.com</a>><br>
Founder at Star2Billing (<a href="http://www.star2billing.com" target="_blank">www.star2billing.com</a>)<br><br>Tel: <a href="tel:%2B34650784355" target="_blank">+34650784355</a><br>Twitter: <a href="http://twitter.com/areskib" target="_blank">http://twitter.com/areskib</a> <br>
LinkedIn: <a href="http://www.linkedin.com/in/areski" target="_blank">http://www.linkedin.com/in/areski</a> <u></u><u></u></p></div></div></div></div><p class="MsoNormal"><br><br clear="all"><u></u><u></u></p><div><p class="MsoNormal">
<u></u> <u></u></p></div><p class="MsoNormal">-- <br>Kind regards,<br>/Areski<br><br>----<br>Arezqui Belaid, <<a href="mailto:areski@gmail.com" target="_blank">areski@gmail.com</a>><br>Founder at Star2Billing (<a href="http://www.star2billing.com" target="_blank">www.star2billing.com</a>)<br>
<br>Tel: <a href="tel:%2B34650784355" value="+34650784355" target="_blank">+34650784355</a><br>Twitter: <a href="http://twitter.com/areskib" target="_blank">http://twitter.com/areskib</a> <br>LinkedIn: <a href="http://www.linkedin.com/in/areski" target="_blank">http://www.linkedin.com/in/areski</a> <u></u><u></u></p>
</div></div></div></div></div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br>Kind regards,<br>/Areski<br><br>----<br>Arezqui Belaid, <<a href="mailto:areski@gmail.com" target="_blank">areski@gmail.com</a>><br>
Founder at Star2Billing (<a href="http://www.star2billing.com" target="_blank">www.star2billing.com</a>)<br><br>Tel: +34650784355<br>Twitter: <a href="http://twitter.com/areskib" target="_blank">http://twitter.com/areskib</a> <br>
LinkedIn: <a href="http://www.linkedin.com/in/areski" target="_blank">http://www.linkedin.com/in/areski</a>
</div>