FAQ
Note: this is not a Python question per se.

I'm looking for a piece of software to aid in reviewing a document
through the web - click on a paragraph tag, have the comment added
(highlighted in some way). The wiki style doesn't seem to quite do it,
as the core document is not protected. I haven't found much in web
searches, and nothing where the software seems to be free.

I'd of course love it if this were done through Python since I'm on a
bit of an advocacy kick...but in the end it doesn't matter much.
Anybody know if anything like this is happening in any of the web
services projects?


Mats Wichmann

Search Discussions

  • Wayne Pierce at Mar 2, 2002 at 2:52 am

    Mats Wichmann wrote:
    Note: this is not a Python question per se.

    I'm looking for a piece of software to aid in reviewing a document
    through the web - click on a paragraph tag, have the comment added
    (highlighted in some way). The wiki style doesn't seem to quite do it,
    as the core document is not protected. I haven't found much in web
    searches, and nothing where the software seems to be free.
    If Wiki allowed for password protection would it fit your requirements?
    I run a Wiki on Zope (ZWiki), which allows for password protection.
    You could also use Apache and setup the httpd.conf file to require
    authentication when someone accessed that part of the site.

    Something like Zope's CMF Workflow[2] might also be a good fit....then
    there's OpenFlow[3] (also running on Zope :).
    I'd of course love it if this were done through Python since I'm on a
    bit of an advocacy kick...but in the end it doesn't matter much.
    Anybody know if anything like this is happening in any of the web
    services projects?
    I don't know if these __exactly__ match what you are looking for, but
    hopefully they will get you started.

    [1] http://www.zwiki.org/FrontPage
    [2] http://cmf.zope.org/design/design/interfaces/tools/IF_portal_workflow
    [3] http://openflow.sourceforge.net/

    --
    Wayne Pierce
    web: http://www.mishre.com
    email: wayne at mishre.com

    "What you need to know."
  • Test at Mar 2, 2002 at 4:03 am
    Backtalk is another python-based framework.

    http://sourceforge.net/projects/backtalk/
  • Mats Wichmann at Mar 2, 2002 at 4:16 pm
    On Fri, 01 Mar 2002 18:52:42 -0800, Wayne Pierce wrote:

    :
    :Mats Wichmann wrote:
    :> Note: this is not a Python question per se.
    :>
    :> I'm looking for a piece of software to aid in reviewing a document
    :> through the web - click on a paragraph tag, have the comment added
    :> (highlighted in some way). The wiki style doesn't seem to quite do it,
    :> as the core document is not protected. I haven't found much in web
    :> searches, and nothing where the software seems to be free.
    :
    :If Wiki allowed for password protection would it fit your requirements?

    Not really. A Wiki works on the model that everyone is the editor; the
    model that I need to operate on is a single editor, many reviewers.


    :Something like Zope's CMF Workflow[2] might also be a good fit....then
    :there's OpenFlow[3] (also running on Zope :).

    My understanding of Zope is limited, but it might provide the
    facilities needed, yes.

    Here's an implementation that's "almost there":

    http://www.quicktopic.com/10/D/9hmkxh7US2d.html

    The thing I want (that I've seen in private in-house implementations)
    is a view that shows the original document and the comment in a single
    view, here you have to click to get the comments.

    I can envision a scheme where a document is broken into objects that
    can be commented on, and on presentation a document object can be
    displayed togther with its' associated comment objects. Sound like
    something Zope could facilitate?

    Hmmm.

    Mats

    Mats Wichmann
  • Henrik Motakef at Mar 2, 2002 at 5:17 pm

    mats at laplaza.org (Mats Wichmann) writes:

    I'm looking for a piece of software to aid in reviewing a document
    through the web - click on a paragraph tag, have the comment added
    (highlighted in some way).
    I once found a project called OpenTheory (http://www.opentheory.org)
    that used a system that might be interesting for you (although it's
    written in Perl, IIRC). Basically, there is one "maintainer" of a
    text, and "project members" can add comments to every paragraph until
    the maintainer releases a new version of the document. Never used it
    myself, though.

    hth
    Henrik
  • Ddoc at Mar 2, 2002 at 7:29 pm

    I'm looking for a piece of software to aid in reviewing a document
    through the web - click on a paragraph tag, have the comment added
    (highlighted in some way).
    Is this what Annotea (Annotation server from the W3C), Third Voice (now
    defunct , and to a lesser extent Allegra are for?


    --
    A
  • Paul Boddie at Mar 4, 2002 at 12:02 pm
    ddoc <news at 92tr.freeserve.co.uk> wrote in message news:<a5r98d$vpi$1 at newsg4.svr.pol.co.uk>...
    I'm looking for a piece of software to aid in reviewing a document
    through the web - click on a paragraph tag, have the comment added
    (highlighted in some way).
    Is this what Annotea (Annotation server from the W3C), Third Voice (now
    defunct , and to a lesser extent Allegra are for?
    I would think so. Unfortunately, Amaya is probably the only browser
    that supports annotations, however.

    Paul
  • Wayne Pierce at Mar 5, 2002 at 4:30 am

    Paul Boddie wrote:
    ddoc <news at 92tr.freeserve.co.uk> wrote in message news:<a5r98d$vpi$1 at newsg4.svr.pol.co.uk>...
    I'm looking for a piece of software to aid in reviewing a document
    through the web - click on a paragraph tag, have the comment added
    (highlighted in some way).
    Is this what Annotea (Annotation server from the W3C), Third Voice (now
    defunct , and to a lesser extent Allegra are for?
    I would think so. Unfortunately, Amaya is probably the only browser
    that supports annotations, however.

    Paul
    There's a plugin in for Mozilla linked from the W3C site and I think I
    saw something about a plugin for IE either available or in the works.
    They also have partial support for making the annotations with any
    JavaScript enabled browser, although it didn't provide the full
    capabilities.

    --
    Wayne Pierce
    web: http://www.mishre.com
    email: wayne at mishre.com

    "What you need to know."
  • Bengt Richter at Mar 2, 2002 at 11:22 pm

    On Sat, 02 Mar 2002 00:22:58 GMT, mats at laplaza.org (Mats Wichmann) wrote:
    Note: this is not a Python question per se.

    I'm looking for a piece of software to aid in reviewing a document
    through the web - click on a paragraph tag, have the comment added
    (highlighted in some way). The wiki style doesn't seem to quite do it,
    as the core document is not protected. I haven't found much in web
    searches, and nothing where the software seems to be free.

    I'd of course love it if this were done through Python since I'm on a
    bit of an advocacy kick...but in the end it doesn't matter much.
    Anybody know if anything like this is happening in any of the web
    services projects?
    If it doesn't have to be too slick, I think you could write relatively
    simple cgi to do it, depending on what you mean by "document".
    Also, with a small collection of doc text pages and a few occasional
    user/reviewers you could get away with something that wouldn't scale
    to a massive online catalog with graphics layout and thousands of reviewers.

    I've thought it would be nice to have something like that for collaborating
    on documentation and/or maybe PEPs.

    What kind of docs are you dealing with?

    Regards,
    Bengt Richter
  • Mats Wichmann at Mar 3, 2002 at 4:38 pm
    On 2 Mar 2002 23:22:36 GMT, bokr at oz.net (Bengt Richter) wrote:

    :On Sat, 02 Mar 2002 00:22:58 GMT, mats at laplaza.org (Mats Wichmann) wrote:
    :
    :>Note: this is not a Python question per se.
    :>
    :>I'm looking for a piece of software to aid in reviewing a document
    :>through the web

    :If it doesn't have to be too slick, I think you could write relatively
    :simple cgi to do it, depending on what you mean by "document".
    :Also, with a small collection of doc text pages and a few occasional
    :user/reviewers you could get away with something that wouldn't scale
    :to a massive online catalog with graphics layout and thousands of reviewers.
    :
    :I've thought it would be nice to have something like that for collaborating
    :on documentation and/or maybe PEPs.
    :
    :What kind of docs are you dealing with?

    Smallish - for my uses, it doesn't have to scale very far. On the
    order of one to dozens of printed pages (should anyone print 'em),
    rather than hundreds, certainly; and with similar orders of magitude
    for number of reviewers. The sorts of docs are spec fragments,
    documentation, whitepapers, maybe FAQ answers.

    Mats Wichmann

Related Discussions

Discussion Navigation
viewthread | post
Discussion Overview
grouppython-list @
categoriespython
postedMar 2, '02 at 12:22a
activeMar 5, '02 at 4:30a
posts10
users7
websitepython.org

People

Translate

site design / logo © 2022 Grokbase