> -----Original Message----- > From: sipx-users-boun...@list.sipfoundry.org > [mailto:sipx-users-boun...@list.sipfoundry.org] On Behalf Of > Lawrence, Scott AVAYA (BL60:9D30) > Sent: Tuesday, January 05, 2010 8:11 AM > To: Josh Patten > Cc: sipx-users@list.sipfoundry.org > Subject: Re: [sipx-users] Wiki time > > On Mon, 2010-01-04 at 13:29 -0600, Josh Patten wrote: > > > I guess now that the holidays are over with it's time to > start getting > > back in the swing of things and one thing I think all of us want to > > see is better documentation. > > I've been waiting until people were back from the holidays to > take up this thread again. For my earlier post on this see: > > http://list.sipfoundry.org/archive/sipx-users/msg19879.html > and > http://wiki.sipfoundry.org/display/~xmlscott/Proposed+sipXecs+ > wiki+organization > > I have a conversion program that will do a first-order > migration of the existing mediawiki content into a space in > wiki.sipfoundry.org. The resulting pages usually require > just a little manual tweaking to be good Confluence content. > I'm hoping that we can spread that effort around. > > Before I start that, I'd like to hear some discussion of how > the user documentation in the new wiki should be organized. > One of the very nice features of Confluence is that there's > hierarchy to the pages - each page has a parent, and siblings > are ordered. The theme I've installed makes that tree > visible on the left side, with the usual ability to expose or > hide branches at each level (the default width of that tree > display is pretty wide, but you can narrow it by dragging the > border between the left side nav panel and the main content > area, or by clicking on a small windowpane icon near the top > right of the page). > > As we clean up and update migrated content pages and move > them into the new documentation, it would be good to already > have at least a notion of what the top level sections should > be in that hierarchy. I'm thinkging something along the > lines of (a grossly incomplete list): > > - Network Infrastructure > (DNS, DHCP, QoS, PoE) > - Users and Internal Call Routing > - PSTN Connectivity > > ... but what I really want to know is what existing administrators > think. What are your top level section suggestions? > > >
It would be nice if there was some way of organizing the documentation so that it is obvious which sipXecs release it applies to. Some components may behave differently in different releases so it would be good if, for example, you could select "4.1.0" and see all the documentation for that release. With the existing wiki pages I'm never quite sure if I'm looking at the correct version of the page for the sipXecs release I'm working on. Dave. _______________________________________________ sipx-users mailing list sipx-users@list.sipfoundry.org List Archive: http://list.sipfoundry.org/archive/sipx-users Unsubscribe: http://list.sipfoundry.org/mailman/listinfo/sipx-users sipXecs IP PBX -- http://www.sipfoundry.org/
