drbowen wrote on Tuesday, April 25, 2006:
Dear Brady,
I would be more than glad to have some help.
Recognizing that there is always more than one way and I am not criticizing what your are proposing, my thoughts in response to your recommendations:
The OpenEMR Manual was created by largely by Rod Roark (with contributions from Andres Paglayan and myself) as a “stand alone” downloadable module. It also largely reflects his way of doing things.
It is intended to be packaged and shipped with new installations in Rod’s business of marketing and supporting OpenEMR installations. This manual is based largely on version 2.8.1.
The advantages of the wiki are that it is easily modifiable and maintainable. Moving the manual to the wiki would make it a living, (less stagnant) document. Moving the Manual to the Wiki would be advantageous to anyone installing and supporting OpenEMR commercially. It would be relatively easy to download and tar-compress a hot new current version.
The HOWTOs in the download section should probably be abandoned. They were included out of expediency while the wiki was under construction but are based on version 2.65ea. (ea for early addition). They are quite old but included but there because of the old linux adage "some documentation is better than no documentation at all."
Moving links in a wiki is not easy. They make creation of new documents a lot easier than changing the architeture after you have already started.
The WikiSandBox exists primarily to give new users a chance to get over their "fear of flying". Modifying a wiki is quite easy and takes a minimal learning curve. For new users it needs to be in a prominent easily recognizable position.
installhowto - agreed
tools link - agreed
Of course we need to create a "Forms HOWTO".
I would like to upgrade the XOOPS site to the current version. The XOOPS deveopers have made a lot of improvements and the wiki (winimod) is a lot better. In particular the current support for CamelHumping is quite strict and very basic. The new version of winimod supports a much freer style
In the current version on oemr.org I have to write:
FreebInstall
In the most recent version I can write:
[[FreeB Install]]
This makes things much clearer to new users (and I hate appearing to be dyslexic on the site).
Thanks for the ideas. I would be glad to have your help on the wiki.
Sam Bowen, MD