Re: [Phpgroupware-users] wiki issues

[Brian Johnson]

Marc Grober (address@hidden) wrote:
>
> Brian Johnson wrote:
>
> > Comments about wiki's ..
> > 1. there IS a tag based mark up system .. the first page of the wiki has 
> > links
> > to info
>
> Actually I looked at the info on formating available (both links to 
> wiki.dotgnu.org  do
> not work and I used the primitives to mark up the URLs as not functioning) 
> and it looked
> like there was a way to format, but being it was very limited and was not 
> what I would
> call tag based, though I suppose primitives like === could be called  a 
> tag...  and
> there
> are some issues in their use, such as the stricken text feature......
>

It seems the wikitavi project page is having db problems, but here is the link
that should work to provide help with wiki formatting:
http://tavi.sourceforge.net/FormattingRules

Most wiki's will take html tags and the other formatting controls are really
shortcuts for matching html tags.

> > 2. you make a big assumption that the final format will be oo.org (and not
> > html, docbook, ascii, mscrap, etc., or a combination)
>
> I think you could call it conjecture based upon prior postings here
>
> > 3. I haven't seen anything as easy for users to use (combination of no setup
> > on their hardware and limited editing skills required) for large numbers of
> > contributors while maintaining version control
>
> there is a cost associated with everything.....
>
> but none of that addresses the question of whether the wiki should contain 
> html mark-up
> or not,  nor does it address how documentation will be moved from the wiki to 
> some other
> form, if that is the intent.
>
>
>

The phpgroupware wiki is intended to be used for a doc development system to
allow as many people to contribute as possible.  Since docs always seem to be
a weak point for software (not just open source projects), it was important to
make it as easy as possible to contribute.

The concept is that app maintainers can then extract information from the wiki
for use in their app documentation which is stored in a few places within the
app directory structure (notes on that are here
http://wiki.phpgroupware.org/index.php?page=ContentsPage)

Currently the format that the docs are stored in within the apps is a mixture
of ascii, html, and other .. we're trying to organize:
a) a method for many people to contribute to the app documentation
b) a method that limits public write access to the "official" docs within the
apps
c) a doc storage and access organization method within the app to make it easy
for normal users while still providing docs to admins and developers


> >
> >
> > Marc Grober (address@hidden) wrote:
> > >
> > > Dumped  the text into the wiki.  I treied it in html and when I realized 
> > > that wiki's
> > > don;t do anything with the tags I replaced that with the plain text..... 
> > > then I
> > > noticed that in other apps you had inserted the html......  (I am 
> > > guessing for the
> > > reason I conclude this note with......)  So which way should it be, and 
> > > lets say
> > > something to that effect at the top.........
> > >
> > >  Don't know much about wikis other than they do not seem to like be very
> > > format-friendly (I assume that somewhere someone has written a script 
> > > that parses
> > > out html and replaces tags with wiki formatting ?)
> > >
> > > I can understand why wikis are a great tool for collaborative editing, 
> > > but I miss a
> > > tag based mark-up tool.....  which means this will eventually have to be 
> > > imported
> > > back into OO to be published....  bit of circle that, no?
> > >
> > > Dave Hall wrote:
> > >
> > > > On Sun, 2004-12-26 at 23:33 -0900, Marc Grober wrote:
> > > > > Well, the sitemgr docs were not that helpful.
> > > > >
> > > > > I have edited the sitemgr.html doc with respect to installation with 
> > > > > some
> > > > > comments
> > > > > http://www.interak.com/~marc/sitemgr.html
> > > > > but the bottom line is that the app still does not work and it 
> > > > > appears that
> > > > > there are perm issues.
> > > >
> > > > You raise several issues in the doc which might point to why sitemgr is
> > > > not working for you.
> > > >
> > > > I have 4 sites running sitemgr - best example is phpgroupware.org (and
> > > > subsites)
> > > >
> > > > I would suggest the you dump the doc - including your comments in to
> > > > wiki.phpgroupware.org and that will allow people to comment clarify bits
> > > > of it for you.  Please make sure that your comments are clearly marked.
> > > >
> > > >
> > >
> > >
> > >
> > > _______________________________________________
> > > Phpgroupware-users mailing list
> > > address@hidden
> > > http://lists.gnu.org/mailman/listinfo/phpgroupware-users
> > >
> > >
> >
> > _______________________________________________
> > Phpgroupware-users mailing list
> > address@hidden
> > http://lists.gnu.org/mailman/listinfo/phpgroupware-users
>
>
>
> _______________________________________________
> Phpgroupware-users mailing list
> address@hidden
> http://lists.gnu.org/mailman/listinfo/phpgroupware-users
>
>