[Encore] enCore-help

[Lennie Irvin]

Hi Everyone,

I would like to echo Jan's call for help in completing this Documentation
Project. If you have some time to play around in High Five and try out how
the help works that would be great.

This documentation was created as a partnership between University of Bergen
(and the LINGO Project), the enCore Consortium, and Texas Tech University.
Let me explain a couple of things about it--

It is single-source documentation which means that the content lives on a
single server and is accessed by every site using enCore v5. The help system
established in the beta High Five site (http://lingo.uib.no:6002/) will be
available for all users of v5. Probably when the help is completed, there
will be a version update with current access to the documentation.

It is primarily designed for the chief context of use--in-program help or
contextual help. It is designed to be useful for users while they are within
enCore. However, as single-source documentation, this content can be
accessed also as a website and as a print pdf file.

Work on this documentation project has been ongoing for over a year.  From
what Jan tells me, he is trying to complete his work on version 1.0 of this
documentation within the next two weeks, so NOW is the time to help if you
are able.

In order not to clog this list with lots of documentation emails, I
recommend that you join the Doc Project Forum within High Five.  This is a
discussion forum set up just for documentation topics.  In order to
subscribe to this list,

1) click on the menu item MAIL/FORUM within High Five
2) click on the light bulb help item
3) look for the help instructions for how to subscribe to a forum (this will
be a good test of the documentation!)
4) subscribe to the forum named "DocProject"  (you have to scroll down a
ways to find it).

Then post your feedback and suggestions into this forum.

Thanks to Jan for all his hard work on this project!!!


Lennie

On 8/10/07, Jan <support at lingo.uib.no> wrote:
>
> Dear members of the enCore mailing-list.
>
> Good news everybody!
> Most of the work "docbooking" the content (produced by Deborah Page and
> her
> students) Lennie Irvin handed  over to me is now mapped into High Five
> (http://lingo.uib.no:6002/). Help content is generated form the Single
> source
> docbook-files when clicking the light-bulbs inside the program.
>
> There are a few  things missing, help files for the "Admin" tab, help text
> for
> main menu (these are ready "docbooked", but needs to be mapped) and
> probably
> some other things.
>
> I think this is a good time for all of you to have a look and tell me what
> you
> like/dislike, do you want more/less/other information, suggest alternative
> solutions on how to present the help-files, or in other words, tell me
> what you
> think of it.
>
> All issues having to do with mark-up for multiple languages, limitations
> for
> different MOO user groups (builder, ..., teacher and wizard), will have to
> wait
> until the English version is complete. I hope we'll get feedback from you
> all
> ASAP, because in about two weeks time I'll have to spend more of my time
> on
> other assignments. Would be nice to have the enCore-help system completed
> by then.
>
> Greetings,
>
> ~Jan~
>
> LINGO
> support at lingo.uib.no
> http://lingo.uib.no
> tlf: 555 88945
> HF-bygget Rom 437
> 5007 Bergen
>



-- 
Lennie Irvin
Assistant Professor, Dept. of English
San Antonio College
PhD student in Tech Comm and Rhetoric, Texas Tech Univ.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://encore-consortium.org/pipermail/encore_encore-consortium.org/attachments/20070810/398590f9/attachment.html