On Mon, 2010-02-01 at 09:48 -0500, Carolyn Beeton wrote:
> I think what is slowing many of us down is that there is not enough
> there yet to see what the structure should look like. Under 4.0 User
> Documentation
> (http://wiki.sipfoundry.org/display/xecsuserV4r0/sipXecs+Version+4.0+Use
> r+Documentation), there is
>
> - Administrator Documentation
> - [seemingly random list of useful stuff]
> - End User Documentation
> - [nothing]
>
> but even that is more structure than exists under the 4.2 Development
> Version page
> (http://wiki.sipfoundry.org/display/xecsuserV4r2/sipXecs+Version+4.2+Dev
> elopment+Version)
>
> A bit of top-level organization would go a long way to help us see where
> new pages should go. Can we migrate the layout of that main page
> (http://wiki.sipfoundry.org/display/oldxx/Main+Page is only a poor
> approximation) from the "old" wiki so that we would have
> - New to sipXecs
> - How to deploy
> - Installation
> - Features
> etc? or at least use this as a starting place...
Fair points... a couple of comments:
* Re-organizing is trivial - if people put updated and improved
content _anywhere_, we can move and reorganize it later if
needed.
* The above is easier if you don't create giant pages that touch
on many different semi-related things (which is typical of many
pages on the old wiki). It's the web - use links.
* My preference would be that for right now no one put anything
into the 4.2 user space - let's get reasonable 4.0 documentation
done first, then when that exists, I'll copy the entire space to
4.2 and people can update it. This is the plan for how all
future versions will be done, so that the new version
documentation gets done incrementally as we do the development.
Of course, if no one does 4.0 pages, that won't work...
* As for introductory content, yes, we need some, and I'd
appreciate help in creating / porting it.
_______________________________________________
sipx-dev mailing list [email protected]
List Archive: http://list.sipfoundry.org/archive/sipx-dev
Unsubscribe: http://list.sipfoundry.org/mailman/listinfo/sipx-dev
sipXecs IP PBX -- http://www.sipfoundry.org/
