Eric,

I wonder if it would be clearer to re-name the entire current "uPortal 3" space to something like "uPortal Sandbox" and create a new uPortal 3 space, moving into it the (relatively few) pages that are fully relevant.  This would effectively separate all the pages that don't actually apply to the code being developed and delivered as uPortal 3 from the pages that do.  It would also create a natural process for how to migrate the good ideas from the sandbox code and documentation into the real uPortal code and documentation -- when they've been revisited and refactored to apply to the code being delivered as uPortal 3, they are welcome to make the jump into the wiki space about uPortal 3 as it is being delivered.

And then I wonder whether creating a new uPortal 3 wiki space is a good idea, or if the uPortal 3 efforts should be undertaken in the existing uPortal wiki space.  The change the project has made in its approach to uPortal 3 is to be more evolutionary.  uPortal 3 *is* uPortal 2, cleaned up quite a bit and with pointed improvements.  So maybe, just as the existing code evolves to become uPortal 3, the existing wiki space evolves to become a wiki space that documents uPortal, inclusive of uPortal 3.

Likewise, I don't think it will be necessary to have an entirely new uPortal manual, more a matter of growing and enhancing the existing uPortal manual wiki space to document the project as it grows and is enhanced.

Andrew





With this progress and new build system I need to get it properly documented and have a place for documentation as this effort moves forward. After looking through the wiki and chatting in IRC I have the following proposal. All documentation in the uPortal 3 space related to the uPortal 3 sandbox code would be consolidated and moved under a uP3-Sandbox page then the uPortal 3 space would be used for documentation of the goals of this effort and documentation of changes as they happen. I'd like to get other thoughts and suggestions as to how to deal with the wiki documentation as well.

-- 
You are currently subscribed to [email protected] as: [EMAIL PROTECTED]
To unsubscribe, change settings or access archives, see http://www.ja-sig.org/wiki/display/JSG/uportal-dev



Reply via email to