<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40"><head><meta http-equiv=Content-Type content="text/html; charset=utf-8"><meta name=Generator content="Microsoft Word 12 (filtered medium)"><style><!--
/* Font Definitions */
@font-face
{font-family:Wingdings;
panose-1:5 0 0 0 0 0 0 0 0 0;}
@font-face
{font-family:Wingdings;
panose-1:5 0 0 0 0 0 0 0 0 0;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:Tahoma;
panose-1:2 11 6 4 3 5 4 4 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman","serif";}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
span.EmailStyle17
{mso-style-type:personal-reply;
font-family:"Calibri","sans-serif";
color:black;}
.MsoChpDefault
{mso-style-type:export-only;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]--></head><body lang=EN-US link=blue vlink=purple><div class=WordSection1><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>[ 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. ]<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>Welcome back to life!<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>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.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>B) BKW created a Jira for the Documentation project at<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><a href="https://jira.freeswitch.org/browse/DOCS">https://jira.freeswitch.org/browse/DOCS</a><o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>Now, unlike a software project I considered the documentation to be self-documenting </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'> For example, if a page is not formatted properly it is apparent to the eye.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>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. <o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>Suggestions?<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>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.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>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. <o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>D) All pages need reformatting on Confluence I'm finding. Please follow the guidelines on<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><a href="https://confluence.freeswitch.org/display/FREESWITCH/Confluence+Wiki+Standards+and+Guidelines">https://confluence.freeswitch.org/display/FREESWITCH/Confluence+Wiki+Standards+and+Guidelines</a><o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><b><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>From your questions:<o:p></o:p></span></b></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>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.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>2) There are many pages that should not be moved, I think.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>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.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>4) Special wiki pages can not be used, correct. Confluence has those built-in.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>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<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><a href="https://confluence.freeswitch.org/display/FREESWITCH/Modules">https://confluence.freeswitch.org/display/FREESWITCH/Modules</a><o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>The Confluence wiki is still a work in progress so we are keeping things "loose" while we discover the best practices to use.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>If anybody finds a better way to do something, please tell us on this mailing list so we all can benefit from it.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>Thanks!<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'>Bote<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:black'><o:p> </o:p></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:areski@gmail.com] <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; ycamargo@xmartek.com<br><b>Subject:</b> Re: FS Docs: wiki to Confluence move<o:p></o:p></span></p></div></div><p class=MsoNormal><o:p> </o:p></p><div><p class=MsoNormal>Hi Bote Man!<o:p></o:p></p><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>Sorry to come back to live so late. I certainly missed everything that has been discussed on the topics, <o:p></o:p></p></div><div><p class=MsoNormal>but if you still need help on moving documentation let me know, Ken just sorted my confluence access <o:p></o:p></p></div><div><p class=MsoNormal>so I m ready to get started.<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>My comments on few things, sorry in advance if some points sounds stupid or have been discussed already.<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>What do you think if we put some tracking of the work in place, something like this:<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>A) Define a list of all pages that need to be moved on Spreadsheet <br>B) Push all `validated pages` to a bug tracker (maybe Jira)<br>C) Define a workflow, ie: <br> - Waiting (need to be moved), <br> - Need content review <br> - Review for Deletion (page we think we may want to delete)<br> - Need reformatting (some page has been moved but the formatting is bad so we need to come back to them at some stage)<o:p></o:p></p></div><div><p class=MsoNormal> - Need a menu<br> - Solved<br>D) Then let the folks picking the tasks they want<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>I did a scrapping of the wiki and created a spreadsheet here, the spreadsheet is editable:<o:p></o:p></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><o:p></o:p></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.<o:p></o:p></p></div><div><p class=MsoNormal>* (there is 2858 pages in total)<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>Few things I noted and on which I would appreciate some lights:<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>1) I see some pages that has been moved but not tagged on Secret-Wiki, ie <a href="https://70.169.193.216/wiki/Installation_for_Windows" target="_blank"><span style='color:#3465A4'>https://70.169.193.216/wiki/Installation_for_Windows</span></a> - tag with "category:moved"<o:p></o:p></p></div><div><p class=MsoNormal>Any special reasons why the tag is missing?<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>2) There is page we might not be willing to move, ie <a href="https://70.169.193.216/wiki/Make_test" target="_blank"><span style='color:#3465A4'>https://70.169.193.216/wiki/Make_test</span></a> (maybe we can mark them on a bug tracker for review, waiting for deletion until a BDFL come along and take a decision)<o:p></o:p></p><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>3) This page doesn't use the menu correctly : <a href="https://confluence.freeswitch.org/display/FREESWITCH/Configuring+FreeSWITCH" target="_blank"><span style='color:#3465A4'>https://confluence.freeswitch.org/display/FREESWITCH/Configuring+FreeSWITCH</span></a><o:p></o:p></p></div><div><p class=MsoNormal> We may want to try to use Table content correctly everywhere (<a href="https://confluence.atlassian.com/display/DOC/Table+of+Contents+Macro" target="_blank"><span style='color:#3465A4'>https://confluence.atlassian.com/display/DOC/Table+of+Contents+Macro</span></a>), there is no many pages where we do so, ie <a href="https://confluence.freeswitch.org/display/FREESWITCH/Installation" target="_blank"><span style='color:#3465A4'>https://confluence.freeswitch.org/display/FREESWITCH/Installation</span></a><o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>4) I suppose the User page, Special pages and Talk pages don't need to be moved <a href="http://wiki.freeswitch.org/wiki/User:Vmelachervu" target="_blank"><span style='color:#3465A4'>http://wiki.freeswitch.org/wiki/User:Vmelachervu</span></a><o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>5) Child pages mechanism seems something we may want to consider, see it here in action: <a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+Command+Reference"><span style='color:#3465A4'>https://wiki.asterisk.org/wiki/display/AST/Asterisk+Command+Reference</span></a><o:p></o:p></p></div><div><p class=MsoNormal> Maybe something to consider?<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div></div></div><div><p class=MsoNormal><o:p> </o:p></p></div></div></div></body></html>