On Tue, Jan 5, 2010 at 7:16 AM, Tim Donohue <tdono...@duraspace.org> wrote:
> All,
>
> I feel like we're jumping the gun here.  I wouldn't recommend rushing to
> move to Confluence-based documentation/manual for 1.6 release, as we are
> already so late in the game (and I'd hate to delay anything further).
> Plus, Jeff has got a good process going for DocBook right now, and I
> really don't want to pull the rug out on that process at the last moment.

True, there is no reason it has to be "bound" exclusively to the
release process. This is why I proposed making it ultimately
asynchronous.

> That all being said, Mark D, I appreciate your proof of concept work
> that we can get the Documentation into Confluence relatively easily.

Thank you for the recognition.

> As a bit of background on all this Confluence talk to the Developers out
> there.  DuraSpace is currently investigating migrating the DSpace Wiki
> from MediaWiki over to Confluence  (expect to see more announcements
> about this shortly).

Likewise, excited about this, as I spoke with both you and Brad, I
already walked the path of porting a dump of the dspace wiki to
confluence using Universal Wiki Converter with some limited success
last year, what stopped me moving forward was taking the time to
figure out the ideal settings for that conversion that would correct
for all the broken linking and odd Mediawiki formating etc.

https://plugins.atlassian.com/plugin/details/14575

It would be ideal to see a place to share this experience (Hmm, a
Confluence Space?)  and have such a porting activity can have some
opportunity for feedback.

Anyhow, I am very excited to see some resources being thrown at this.
Am looking forward to the point you guys bring it out into the
community.

 There are a variety of benefits we see in moving
> to Confluence:
> * Able to edit using a basic Word-like interface (WYSIWYG interface)
> * Able to export pages to Word/PDF
> * Support for simple diagrams
> * Capable of supporting the DSpace manual natively to ease editing and
> contributing
> * Better integration into existing DuraSpace.org infrastructure
>
> You'll notice one of those listed is to potentially pull in the DSpace
> Manual to Confluence to ease editing/contributing.  I think it's great
> that Mark D has been able to prove we can get the Documentation into
> Confluence without too much hassle.


>  But, I feel we need to have more
> discussion (likely after 1.6) around how we'd all like to manage the
> Documentation in the longer term.

I'm more motivated to see this happen sooner than later. Mostly
because I started working on the porting last summer and got
side-tracked.  When I finally had a brief amount of time this break to
focus on it, the time it took to complete was indeed minimal.  I want
to see it done and the community moving forward in a new better space.
Especially because my time is limited and I don't want to see this
still languishing in a couple months.


> Let me know if there are any comments/questions/input on any of this.
> We can also discuss this more in our Developers Meeting on Weds (though,
> again, it'd be best to concentrate on getting 1.6 finished up before we
> dig too deep into DocBook vs. Confluence for the longer term).

I thank you for your point of view.  But like I said, I'm not
interested in "stalling" on utilizing this as a tool after finally
getting it setup.  I intend to continue to utilize the Confluence
version for my documentation production and invite anyone seeking an
easier manner of creating the documentation to feel free to
participate there as well. We can certainly label it "Experimental"
until we reach a more consensus.

Mark

-- 
Mark R. Diggory
Head of U.S. Operations - @mire

http://www.atmire.com - Institutional Repository Solutions
http://www.togather.eu - Before getting together, get t...@ther

------------------------------------------------------------------------------
This SF.Net email is sponsored by the Verizon Developer Community
Take advantage of Verizon's best-in-class app development support
A streamlined, 14 day to market process makes app distribution fast and easy
Join now and get one step closer to millions of Verizon customers
http://p.sf.net/sfu/verizon-dev2dev 
_______________________________________________
Dspace-devel mailing list
Dspace-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/dspace-devel

Reply via email to