Re: Server-based (hosted) documentation and user comments (DocBook?)

2008-10-31 Thread Jeremy H. Griffith
On Fri, 31 Oct 2008 15:49:55 -0400, "Shuttleworth, Roger" 
<[EMAIL PROTECTED]> wrote:

>There is an open-source DITA-to-wiki project under way that 
>claims to be able to round-trip between DITA (hence structured 
>Frame or XML editor) and wiki. See
> http://development.lombardi.com/?p=68
>I have not used it, so cannot comment on its capabilities.

That's very interesting!  Thanks, Roger!

In that case, the OP may want to check out Mif2Go, which
provides top-notch conversion from UNstructured Frame to
DITA 1.1, the current version of the standard.  The free
unlimited demo version, and the docs in many formats 
(including DITA), are available at:
  http://www.omsys.com/dcl/download.htm

Note that Mif2Go is *way* less expensive than other
possible options for getting to DITA from unstructured
Frame docs.  If you have structured Frame docs that are
already set up for DITA instead, Mif2Go can still help,
but in that case you should also look at DITA-FMx:
  http://www.leximation.com/dita-fmx/

Either way, going from DITA to/from wiki sounds like
a very good way to go.  While DocBook is a lot older,
DITA can do everything DocBook can, and much much more.
For a discussion on that point, see:
  http://tech.groups.yahoo.com/group/dita-users/message/12132

HTH!

-- Jeremy H. Griffith, at Omni Systems Inc.
  <[EMAIL PROTECTED]>  http://www.omsys.com/
___


You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to 
[EMAIL PROTECTED]
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.


RE: Server-based (hosted) documentation and user comments (DocBook?)

2008-10-31 Thread Shuttleworth, Roger
There is an open-source DITA-to-wiki project under way that claims to be able 
to round-trip between DITA (hence structured Frame or XML editor) and
wiki. See http://development.lombardi.com/?p=68. I have not used it, so cannot 
comment on its capabilities.

Regards,

Roger Shuttleworth
London, Canada

-Original Message-
From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED] On Behalf Of Michael O'Neill
Sent: October 31, 2008 3:16 PM
To: Crimmin, Peter; framers@lists.frameusers.com
Subject: RE: Server-based (hosted) documentation and user comments (DocBook?)

One additional note, MoinMoin wiki can be configured to allow users to
output content as/via/through (not sure of the right terminology)
DocBook.  I haven't explored this yet to see whether that's HTML output
or PDF output (or both).  

This is something I'd like to know more about, as to me it would be
pretty compelling for us to take care of the source->wiki workflow and
let users generate their own PDFs on demand from the wiki, if they so
desire.

-Michael

-Original Message-
From: [EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED] On Behalf Of Crimmin,
Peter
Sent: Friday, October 31, 2008 7:49 AM
To: framers@lists.frameusers.com
Subject: Server-based (hosted) documentation and user comments
(DocBook?)


[cross-posted to TECHWR-L mailing list]
 
Can anyone recommend technologies to do the following:

*   Hosted documentation, available on the internet as a web
service. 

*   Each doc topic allows users to add comments. (e.g. "Here's a
better example to do this task...") 

*   Management tools to moderate user comments, and to handle
documentation updates (retaining the comments). 

*   Authoring tools to produce said documentation. 


The open source community exploits these technologies. How do they do
it? I have an inkling for a solution: FrameMaker>DocBook>ePublisher?
 
Thanks for your ideas
___


You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to 
[EMAIL PROTECTED]
or visit
http://lists.frameusers.com/mailman/options/framers/moneill%40meta-comm.
com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.
___


You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to 
[EMAIL PROTECTED]
or visit 
http://lists.frameusers.com/mailman/options/framers/roger_shuttleworth%40tvworks.com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.
___


You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to 
[EMAIL PROTECTED]
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.


RE: Server-based (hosted) documentation and user comments (DocBook?)

2008-10-31 Thread Michael O'Neill
One additional note, MoinMoin wiki can be configured to allow users to
output content as/via/through (not sure of the right terminology)
DocBook.  I haven't explored this yet to see whether that's HTML output
or PDF output (or both).  

This is something I'd like to know more about, as to me it would be
pretty compelling for us to take care of the source->wiki workflow and
let users generate their own PDFs on demand from the wiki, if they so
desire.

-Michael

-Original Message-
From: [EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED] On Behalf Of Crimmin,
Peter
Sent: Friday, October 31, 2008 7:49 AM
To: framers@lists.frameusers.com
Subject: Server-based (hosted) documentation and user comments
(DocBook?)


[cross-posted to TECHWR-L mailing list]
 
Can anyone recommend technologies to do the following:

*   Hosted documentation, available on the internet as a web
service. 

*   Each doc topic allows users to add comments. (e.g. "Here's a
better example to do this task...") 

*   Management tools to moderate user comments, and to handle
documentation updates (retaining the comments). 

*   Authoring tools to produce said documentation. 


The open source community exploits these technologies. How do they do
it? I have an inkling for a solution: FrameMaker>DocBook>ePublisher?
 
Thanks for your ideas
___


You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to 
[EMAIL PROTECTED]
or visit
http://lists.frameusers.com/mailman/options/framers/moneill%40meta-comm.
com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.
___


You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to 
[EMAIL PROTECTED]
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.


RE: Server-based (hosted) documentation and user comments (DocBook?)

2008-10-31 Thread Michael O'Neill
One possible workflow would be:
FrameMaker-> ePublisher-> Wiki (MoinMoin, MediaWiki, something else?).

Wiki would allow users to add comments, enhance topics as they see fit.
However, I don't think there is a workflow for round-tripping.



-Original Message-
From: [EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED] On Behalf Of Crimmin,
Peter
Sent: Friday, October 31, 2008 7:49 AM
To: framers@lists.frameusers.com
Subject: Server-based (hosted) documentation and user comments
(DocBook?)


[cross-posted to TECHWR-L mailing list]
 
Can anyone recommend technologies to do the following:

*   Hosted documentation, available on the internet as a web
service. 

*   Each doc topic allows users to add comments. (e.g. "Here's a
better example to do this task...") 

*   Management tools to moderate user comments, and to handle
documentation updates (retaining the comments). 

*   Authoring tools to produce said documentation. 


The open source community exploits these technologies. How do they do
it? I have an inkling for a solution: FrameMaker>DocBook>ePublisher?
 
Thanks for your ideas
___


You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to 
[EMAIL PROTECTED]
or visit
http://lists.frameusers.com/mailman/options/framers/moneill%40meta-comm.
com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.
___


You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to 
[EMAIL PROTECTED]
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.