asterisk users - Sep 2003 - OT: Creating documentation using a web interface

Hello all,

I would like to document some things I am doing with asterisk, but would
prefer to do this from a web interface.  I am unfamiliar with any
software that allows you to create online documentation from a web
interface.  Ideally I will be able to create documentation online from a
browser, which then when saved, is immediately ready to be read online.
Perhaps I can setup different authors who are also allowed to create
documentation, or have a section where users to the site can create
their own documentation and submit it for inclusion.  A section to
submit documentation edits would be nice, as well as maybe a history
timeline or something like that?

Just some thoughts.  If you know of something like this, please let me
know.  In the meantime, I'll be googling some more.

Thanks,

--
Leif Madsen - Telecommunications Technology
Sheridan College - Trafalgar Campus
ICQ: 3445119
FWD: 18924

> -----Original Message-----
> From: asterisk-users-admin@lists.digium.com [mailto:asterisk-users-
> admin@lists.digium.com] On Behalf Of Leif Madsen
> Sent: Saturday, September 06, 2003 10:42 AM
> To: asterisk-users@lists.digium.com
> Subject: [Asterisk-Users] OT: Creating documentation using a web
interface
> 
> Hello all,
> 
> I would like to document some things I am doing with asterisk, but
would
> prefer to do this from a web interface.  I am unfamiliar with any
> software that allows you to create online documentation from a web
> interface.  Ideally I will be able to create documentation online from
a
> browser, which then when saved, is immediately ready to be read
online.
> Perhaps I can setup different authors who are also allowed to create
> documentation, or have a section where users to the site can create
> their own documentation and submit it for inclusion.  A section to
> submit documentation edits would be nice, as well as maybe a history
> timeline or something like that?
> 
> Just some thoughts.  If you know of something like this, please let me
> know.  In the meantime, I'll be googling some more.
Hmmmmm....

http://www.interactivetools.com/products/docbuilder/

This looks kind of what I want, but I am looking for a free version of
something preferably.  I would pay for something, but at this time I am
unable to because of commitments to having to pay for tuition (still in
school).

Getting closer though... back to the google :)

Thanks,
Leif Madsen.

> Hmmmmm....
> 
> http://www.interactivetools.com/products/docbuilder/
> 
> This looks kind of what I want, but I am looking for a free version of
> something preferably.  I would pay for something, but at this time I
am
> unable to because of commitments to having to pay for tuition (still
in
> school).
> 
> Getting closer though. .. back to the google :)
Jac Kersing mentioned to me to try twiki.  Has anyone else used this
with success to create documentation?

Installing now as a test platform.

Thanks,
Leif Madsen.

here is program I would recommend:
www.helpandmanual.com

really easy to use, full of the features.

Senad

-----Original Message-----
From: asterisk-users-admin@lists.digium.com
[mailto:asterisk-users-admin@lists.digium.com]On Behalf Of Leif Madsen
Sent: 06 September 2003 17:02
To: asterisk-users@lists.digium.com
Subject: RE: [Asterisk-Users] OT: Creating documentation using a web
interface

> Hmmmmm....
> 
> http://www.interactivetools.com/products/docbuilder/
> 
> This looks kind of what I want, but I am looking for a free version of
> something preferably.  I would pay for something, but at this time I
am
> unable to because of commitments to having to pay for tuition (still
in
> school).
> 
> Getting closer though. .. back to the google :)
Jac Kersing mentioned to me to try twiki.  Has anyone else used this
with success to create documentation?

Installing now as a test platform.

Thanks,
Leif Madsen.

_______________________________________________
Asterisk-Users mailing list
Asterisk-Users@lists.digium.com
http://lists.digium.com/mailman/listinfo/asterisk-users

> -----Original Message-----
> From: asterisk-users-admin@lists.digium.com
> [mailto:asterisk-users-admin@lists.digium.com]On Behalf Of Leif Madsen
> Sent: Saturday, September 06, 2003 9:42 AM
> To: asterisk-users@lists.digium.com
> Subject: [Asterisk-Users] OT: Creating documentation using a web
> interface
>
>
> Hello all,
>
> I would like to document some things I am doing with asterisk, but would
> prefer to do this from a web interface.  I am unfamiliar with any
> software that allows you to create online documentation from a web
> interface.  Ideally I will be able to create documentation online from a
> browser, which then when saved, is immediately ready to be read online.
> Perhaps I can setup different authors who are also allowed to create
> documentation, or have a section where users to the site can create
> their own documentation and submit it for inclusion.  A section to
> submit documentation edits would be nice, as well as maybe a history
> timeline or something like that?
>
> Just some thoughts.  If you know of something like this, please let me
> know.  In the meantime, I'll be googling some more.
>
> Thanks,
>
> --
> Leif Madsen - Telecommunications Technology
> Sheridan College - Trafalgar Campus
> ICQ: 3445119
> FWD: 18924
>
>
>
> _______________________________________________
> Asterisk-Users mailing list
> Asterisk-Users@lists.digium.com
> http://lists.digium.com/mailman/listinfo/asterisk-users
Check out Zope.  It can be really complex or fairly simple.
http://www.zope.org


Andy

Why not create the docs in a word processor and save it out as HTML?  
Virtually all the word processor programs will do that now.  OpenOffice 
(available free for Linux, MS Windows, and possibly Mac) is nice for this, or 
you could use KWord (also free), or software for that "other" platform
(if
you don't mind writing the same document 5 times because it crashed in the 
middle of a save or right after you wrote a whole page more).

If you do not need a collaborative ability in the software this is a good way 
to go.

Tim

On Saturday 06 September 2003 08:42 am, Leif Madsen
wrote:
> Hello all,
>
> I would like to document some things I am doing with asterisk, but would
> prefer to do this from a web interface.  I am unfamiliar with any
> software that allows you to create online documentation from a web
> interface.  Ideally I will be able to create documentation online from a
> browser, which then when saved, is immediately ready to be read online.
> Perhaps I can setup different authors who are also allowed to create
> documentation, or have a section where users to the site can create
> their own documentation and submit it for inclusion.  A section to
> submit documentation edits would be nice, as well as maybe a history
> timeline or something like that?

Do-you knox PhpNuke : http://phpnuke.org/
or SPIP : http://www.spip.net/en

I use SPIP for a bunch of web sites
 and I guess this could be very easy for you to publish doc with that

>
> I would like to document some things I am doing with asterisk, but would
> prefer to do this from a web interface.  I am unfamiliar with any
> software that allows you to create online documentation from a web
> interface.  Ideally I will be able to create documentation online from a
> browser, which then when saved, is immediately ready to be read online.
> Perhaps I can setup different authors who are also allowed to create
> documentation, or have a section where users to the site can create
> their own documentation and submit it for inclusion.  A section to
> submit documentation edits would be nice, as well as maybe a history
> timeline or something like that?

You betcha!! We use it at work and we actually have non-html people 
contributing and fixing typos and errors..its easy to set up and easy to 
use.

Leif Madsen wrote:
>>Hmmmmm....
>>
>>http://www.interactivetools.com/products/docbuilder/
>>
>>This looks kind of what I want, but I am looking for a free version of
>>something preferably.  I would pay for something, but at this time I
>>    
>>
>am
>  
>
>>unable to because of commitments to having to pay for tuition (still
>>    
>>
>in
>  
>
>>school).
>>
>>Getting closer though. .. back to the google :)
>>    
>>
>
>Jac Kersing mentioned to me to try twiki.  Has anyone else used this
>with success to create documentation?
>
>Installing now as a test platform.
>
>Thanks,
>Leif Madsen.
>
>_______________________________________________
>Asterisk-Users mailing list
>Asterisk-Users@lists.digium.com
>http://lists.digium.com/mailman/listinfo/asterisk-users
>  
>
-- 
Only in America do banks leave both doors open and then chain the pens to 
the counters


http://ccicolorado.org
Exceptional Dogs for Exceptional People - Help Out Today!


-------------- next part --------------
An HTML attachment was scrubbed...
URL:
http://lists.digium.com/pipermail/asterisk-users/attachments/20030909/77f5b17f/attachment.htm