It is called confluence. ============================ Tony Graziano, Manager Telephone: 434.984.8430 Fax: 434.984.8431
Email: tgrazi...@myitdepartment.net LAN/Telephony/Security and Control Systems Helpdesk: Telephone: 434.984.8426 Fax: 434.984.8427 Helpdesk Contract Customers: http://www.myitdepartment.net/gethelp/ ----- Original Message ----- From: sipx-users-boun...@list.sipfoundry.org <sipx-users-boun...@list.sipfoundry.org> To: 'Discussion list for users of sipXecs software' <sipx-users@list.sipfoundry.org>; t...@sharedcom.net <t...@sharedcom.net> Sent: Sun Nov 21 21:58:26 2010 Subject: Re: [sipx-users] Wiki cleanup day results Martin, The Sipfoundry.org site is based on a CMS system if I'm not mistaken. I know the old one was Joomla, I'm not sure what the new one is. Maybe some of the content on the wiki is better served being on the web site, within specific pages that are dedicated to things like documentation, etc. Just a thought. From: sipx-users-boun...@list.sipfoundry.org [mailto:sipx-users-boun...@list.sipfoundry.org] On Behalf Of Martin Steinmann Sent: Sunday, November 21, 2010 4:19 PM To: t...@sharedcom.net; 'Discussion list for users of sipXecs software' Subject: Re: [sipx-users] Wiki cleanup day results Tim We will take all the help we can get - many thanks for your offer. If you are available we could talk tomorrow to help you get started and get the necessary rights. Let me know --martin From: sipx-users-boun...@list.sipfoundry.org [mailto:sipx-users-boun...@list.sipfoundry.org] On Behalf Of Tim Ingalls Sent: Saturday, November 20, 2010 9:30 PM To: Discussion list for users of sipXecs software Subject: Re: [sipx-users] Wiki cleanup day results I'd like to help with the organization of the Web site. I'm not a programmer, and I'm new to the sipX project, but I think this is an area that I could contribute. I find the navigation of the site completely maddening, especially with the recent changes made in the past week. I think the whole navigation structure should be scrapped and a new information structure and menu system formulated. Just a few examples of issues I've found with the site: 1. When you are looking for something simple from the main page, (like the download directory) you can't easily find it. From the main page of www.sipfoundry.org, there isn't even a direct link to the sipXecs pages (like the Start Here page). I ended up having to randomly click on things until I found (three or four pages later) a link to the sipXecs start page. 2. I noticed that links from outside sites (like ezuce.com) go to links that don't exist or have been moved. Drupal could fix that by automatically redirecting pages that get merged, deleted, renamed, or moved. 3. There are a lot of pages that are incomplete, like one of two pages with instructions on how to get sipXecs installed on Debian, but these pages are still listed in the menu pane to the left. The old or incomplete pages are given the same weight as the current pages. 4. The strongest content gets buried within minutia. 5. There doesn't seem to be a good information flow that would follow the workflow involved in getting initially familiarized with sipXecs all the way to implementing and supporting an installed instance. The learning curve is made very difficult because a person needs to read through a ton of information scattered around before they can develop a cognitive map of the process. I had no problem implementing (from source code) Asterisk, FreePBX, Trixbox, etc., but I've barely scratched the surface of implementing sipXecs. Have you considered using Drupal to manage the site? Drupal does everything a wiki can do and more. It could make the task of managing the site simpler by implementing a workflow process for approval of new pages and edits when appropriate. Changing menu structure is a snap. That would introduce order by allowing one or two people who know the plan for the site to control its evolution. Is there one person who is in charge of the structure of the site? If not, there should be. Otherwise, it becomes chaotic. I know it's a wiki, but wikis have a problem of introducing chaos since everyone has their own idea of where site content should go. Wikis also have a problem with enforcing content standards for completeness, readability, relevance, correctness, etc. If you look at Wikipedia, they had to create a ton of standards and processes to keep the information from becoming a chaotic mess. The first thing I would do is to logically map out the structure of all of the information that needs to be presented and catalog how the existing content relates. Thanks, Tim Ingalls Shared Communications, Inc. <file:///C:\Program%20Files%20(x86)\openUCToolbar\StatusImages\phone.png> 801-618-2102 Office Douglas Hubler wrote: Everyone, We had a successful wiki cleanup day although there is still much more to do. Thanks to all the participated. Here are the details There was more duplication information that even i expected. This was mostly because pages could not be found and so new pages were created. This issue snowballed for many years. There were a couple reasons why pages were not found: * overall navigation is not clean * pages had many levels deep of classification with no common thought to a classification that wasn't overlapping with other classifications. * automatic indexing appears to not be working. This probably happened after the move from avaya To this end, we decided to * classification - start out with only a few, mutually exclusive classifications. I did restore a few sub-classifications for things phone and gateway vendors. * navigation - use "labels" to group similar pages that in different classifications but are related. Examples: security, diagnostics, polycom,... What's left to do * there are still many pages that have not been moved into the proper classification. These show in the navigation starting below "Testimonials" * there are still many pages where old information has not been removed * there are still several pages that have similar content that need to be consolidated * confluence still isn't automatically indexing new pages. i don't know what's wrong i ran thru a number of fixes other folks have reported works. this still needs to be fixed Even once the above work is done, we need an ongoing process to enforce classifications and remove duplication. I created a wiki team http://wiki.sipfoundry.org/display/sipXecs/Documentation+Team who is responsible for keeping the wiki in proper health. Volunteers will help recognize duplication or improper classification and stamp it out early. That could be you? If you cannot find your pages, please do not create a new one, try searching for it. If that doesn't work, try browsing for it in the pages list. if that doesn't work, then maybe it's time create a new page. feel free to email me as well in case there was a mistake in the cleaning process. _______________________________________________ sipx-users mailing list sipx-users@list.sipfoundry.org List Archive: http://list.sipfoundry.org/archive/sipx-users/ _______________________________________________ sipx-users mailing list sipx-users@list.sipfoundry.org List Archive: http://list.sipfoundry.org/archive/sipx-users/