Re: [eGroupWare-users] Manuals and Documentation, current situation

[Frank-D <fra...@di...>]

Hi all,

I just found one more thing to improve the usability of the community and
the public appereance of egw.
The Tab  Community does show sort of a mission statemant:
http://www.egroupware.org/community
There are no more links, only one the infolog (
http://www.egroupware.org/egroupware/infolog ), which shows only irrelevant
entries, if you are not logged in and shows outdated entries mixed with
test-entries if logged in.

the very relevant page http://www.egroupware.org/join should be shown as
start page of category Community (using sitemgr words now), the "about" page
renamed to "Community-Mission" or even added to the Constitution page.
The Link to infolog has to be removed. And Infolog should be disabled for
most users (anybody using it here?).

Imho egrouware has great ways for everybody to contribute, at the moment
it's quite difficult to find those ways.

best regards Frank




Frank-D wrote:
> 
> Hi Ralf, Hi Wolf,
> 
> thank you very much for your answers. thinking about my post, driving
> home, I already had the idea, that maybe, if I visit the Wiki logged in,
> there will be the possibility to edit.
> 
> Imho this is great. I think with some minor changes to the website, the
> edit-access to the wiki could be made more transparent and easier to use
> (I think it's not just chance, that I didn't know why I already was able
> to edit the wiki). I will discuss this in the next sentences:
> 
> To access the wiki in edit-mode you have to leave the sitemgr-site area
> and switch to the egroupware view. In order to access edit-mode more
> easily I just told my browser to always log me into the egroupware website
> (username, password). If I do this, it's hard to find a way (by clicking
> not by URL itself) to access the groupware part (and leave sitemgr-site)
> the only possibility I found is, "community->join" and than e.g.
> "eGroupWare.org's eGroupWare installation". There is no way accessing the
> wiki (edit-option) reading the Documentation. And I already did setup two
> sitemgr-site websites.
> 
> What I propose: A small html-module on top or beneath the
> Documentation-Start page, which will be visible in all the wiki this way.
> 
> suggestion for text:
> visible for people logged in (in sitemgr-site):
> "You can edit most sites of this wiki (exept adminstrative sites like
> AdminDecisions and
> ProjectMembers). *Click here to access the wiki in order to edit the
> content* (link to wiki [http://www.egroupware.org/egroupware/wiki/], leave
> sitemgr-site)"
> 
> If there is a possibilty to pass the current wiki site (of sitemgr-site)
> via the URL, this would be nice, too.
> 
> visible for people not logged in:
> This Documentation is based on a Wiki. As a community member, you can edit
> and add content to the wiki, just login first, *clicking here*
> (http://www.egroupware.org/egroupware/login.php?cd=1&domain=www.egroupware.org),
> or using the login dialogue on the bottom left of this page. If you have
> no account yet, *click here to register* (link to registration
> http://www.egroupware.org:8080/egroupware/registration/ )
> 
> "This documentation is the eGroupWare community area for development
> drafts, discussion and documentation. Want to learn Wiki formatting? See
> WikkiTikkiTavi or play around in the SandBox." which is part of the
> wiki-startpage could stay.
> The formatting sentence, could be moved to the html-module for logged in
> users.
> 
> Those changes I proposed can be done very easily. Other feature request,
> which can be derived from the difficult edit-access:
> add the feature to edit wiki-sites to the sitemgr-wiki module. A
> automatically added link to the wiki page for users with edit rights,
> would do fine.
> I will add the feature request to the tracker
> 
> best regards Frank
> 
> 
> 
> 
> 
> 
> Wolf Fle wrote:
>> 
>> he ralf,
>> the main restrictions of the wiki are two:
>> 1. there is no table of contents
>> 2. there ist no chance to comment
>> thats why i prefer the structure of a forum or mixed like:
>> http://www.php.net/manual/de/function.preg-replace.php
>> 
>> additionally i like bug-fix and feature-request with ebay-like
>> competition.
>> what do you think?
>> wolf
>> 
>> 
>> Ralf Becker-3 wrote:
>>> 
>>> Hi Frank,
>>> 
>>> just a little correction, most parts of the wiki are editable by every
>>> registered user. Only some administrativ pages (AdminDecisions,
>>> ProjectMembers, ...) and the main index is protected.
>>> 
>>> So there's (nearly) no restriction in updating or adding content to the
>>> wiki.
>>> 
>>> Ralf
>>> 
>>> Frank-D schrieb:
>>>> Hi all,
>>>> 
>>>> At the moment I am writing mails to the mailinglists, if I want to
>>>> share my
>>>> knowledge about something. I want to contribute in a  more structured
>>>> way,
>>>> too. I myself am a little bit confused about the many different ways
>>>> the
>>>> knowledge seems to be documented at the moment. I think this may be
>>>> improved
>>>> and in the following lines I want to describe the situation how I
>>>> observe it
>>>> at the moment (please correct me, if I a wrong somewhere), in order to
>>>> start
>>>> a discussion
>>>> 
>>>> Mailinglists and nabble:
>>>> this is the part visited most often by the community, two parallel ways
>>>> to
>>>> access (mailinglist and nabble) serve different needs. quite nice
>>>> search
>>>> functionalities, recently nabble seems to have some problems offering
>>>> the
>>>> service, seperate mailinglists for several languages
>>>> the forum (nabble) is very easy to be used
>>>> 
>>>> Knowbase:
>>>> all together 35 articles. In many categories, there is no content at
>>>> all.
>>>> Nice way to rate content.  No new content for 2008 so far. Some really
>>>> important articles, some article which contain only a link to the wiki
>>>> or
>>>> say, that the content is outdated
>>>> altogether: really small amount of content, which could migrated to
>>>> another
>>>> container (e.g. wiki) quite easily, management of multi-lingual content
>>>> is
>>>> not supported (?)
>>>> 
>>>> Wiki (Documentation):
>>>> A lot of content. The user manuals (both the German and the English
>>>> one) are
>>>> content of the wiki, too. Multilingual content management support.
>>>> The manuals and other pages sometimes seem to have parallel structure.
>>>> The
>>>> manual references additional pages, which are not part of the (printed)
>>>> manual, too (?).
>>>> The wiki is updated very often. The content is quite reliable and up-to
>>>> date. Only a few people have edit-access.
>>>> 
>>>> News:
>>>> News are used to display important information on the homepage. The
>>>> information is always published somewhere else, too (Wiki, mailinglist
>>>> etc)
>>>> I think this is how News should be used.
>>>> 
>>>> Community: Tracker for Feature Request and Bugs, everything fine,
>>>> sometimes
>>>> there are references to nabble
>>>> 
>>>> http://www.egroupware-deutschland.org/
>>>> phpBB based Forum (no mailinglist); used especially for FAQ. A team of
>>>> authors extracts the most important questions and answers from the
>>>> mailinglists (nabble etc), all together 43 posts, which have more the
>>>> characteristic of articles, than discussions
>>>> no link from egroupware.org website
>>>> 
>>>> conclusion:
>>>> highly distributed information, which makes searching quite difficult
>>>> and
>>>> might irritate new users (after some time you know, that nabble and the
>>>> wiki
>>>> are the places to look). Only few people do contribute to the more
>>>> condensed
>>>> and stable documentation part (like wiki and manual)
>>>> 
>>>> Questions to be considered:
>>>> What is the future of nabble? Can we rely on them, or is the service in
>>>> danger of being shut down? (I simply don't know nothing about this, I
>>>> only
>>>> experienced their maintenance problems?
>>>> 
>>>> Suggestions:
>>>> 1. Migrate content from Knowbase to Wiki, disable Knowbase in
>>>> egroupware.org
>>>> 2. Give the http://www.egroupware-deutschland.org/ authors to the
>>>> german FAQ
>>>> inside the wiki (edit) and move the content from
>>>> http://www.egroupware-deutschland.org/ to this FAQ (of course, only if
>>>> they
>>>> agree)
>>>> 3. think about a way of commenting/contributing to wiki for non-editors
>>>> (perhaps comments, or a edit-able sister-site for each important site,
>>>> or
>>>> publishing workflow) This way the people writing the wiki (great job!)
>>>> could
>>>> easier access and integrate contribution from the community (less own
>>>> work,
>>>> even better/more content), 
>>>> 
>>>> 
>>>> best regards Frank
>>> -- 
>>> Ralf Becker
>>> eGroupWare Training & Support ==> http://www.egroupware-support.de
>>> Outdoor Unlimited Training GmbH [www.outdoor-training.de]
>>> Handelsregister HRB Kaiserslautern 3587
>>> Geschäftsführer Birgit und Ralf Becker
>>> Leibnizstr. 17, 67663 Kaiserslautern, Germany
>>> Telefon +49 (0)631 31657-0
>>> 
>>> -------------------------------------------------------------------------
>>> This SF.net email is sponsored by: Microsoft
>>> Defy all challenges. Microsoft(R) Visual Studio 2008.
>>> http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
>>> _______________________________________________
>>> eGroupWare-users mailing list
>>> eGr...@li...
>>> https://lists.sourceforge.net/lists/listinfo/egroupware-users
>>> 
>>> 
>> 
>> 
> 
> 

-- 
View this message in context: http://www.nabble.com/Manuals-and-Documentation%2C-current-situation-tp16048035s3741p16395302.html
Sent from the egroupware-users mailing list archive at Nabble.com.