manual
389
edits
Changes
Example of a composite editor
* Aug 11, 2014 - ''VRM'' says: "The manual is inaccurate ...., or just plain wrong. The developers expect you to read the whole manual before attempting anything, yet they provide directions that you’ll not remember by the time you actually get to the software. Also, as for the manual, wall-of-text alert. The program icons? Some are '''mystery meat''', where you guess what they are (Why does that green tree split apart at the bottom?)" Biggest Con: ... I don’t want to read 50 pages of manual to find out if it does or not.
* Jun 17, 2014 - ''bh'' says: "The Manuel in not helpful. ... "
* Sep 23, 2015 - {{bug|8665#c44667}} ''asharpham'' says: " I've said it before but the Manual leaves a lot to be desired. It isn't user friendly because it's been written by the developers. Developers don't speak "user friendly" so us mere mortals can find it hard to follow. I've learned not to go to the manual for advice because I just don't understand most of the instructions."
{{man note|Note that in some cases, |the criticisms quoted are accompanied by positive remarks. The comments in some cases also mention specific interface issues. None of these are considered here.}}
* A comment:
# Repeat 4-6 for death event
# Click OK
Total: 14 clicks, or 7 clicks and 15 to 17 keystrokes, plus the data you are entering (including selection of place)<br>- '''From: Michael White - 2008-02-11 - [http://sourceforge.net/p/gramps/mailman/message/18563150/ (Gramps-users) My thoughts on usability/data entry]'''</blockquote>
* Another comment:
<blockquote>When I add a person in PAF, or Ancestry, I see one screen where I enter name, gender, and main events. When I do the same in Gramps, I see half a dozen screens, one for the person, one extra to add each event, and another extra to add a location or to choose an existing one. That's a lot of work, and when I want to enter birth, baptism, death, and burial, I need at least 9 screens in Gramps, where PAF still has only one. And in Gramps, it's actually more, because many times I need an extra click to see whether the location that I want to enter already exists in the database. In those occasions, it is not half a dozen, but a full one,really!<br>- '''From: Enno Borgsteede - 2014-03-31 - [http://sourceforge.net/p/gramps/mailman/message/32167521/ Re: (Gramps-devel) Gramps 3.4.8 from GIT --> Sources]'''</blockquote>
== Examples ==
An example of the approach of having editors which edit more data is Personal Ancestral File (PAF). The Edit Individual window combines editors for name, main events, other information, other events etc. I presume that more 'other events' etc. can be added into the same editor as required. There are buttons beside events etc. which lead to editors for sources etc.
An example of how a possible combined editor might look, see below. Changing or adding basic information like names, birth and death dates and events (including places, which are not shown on the example) should be done directly on this page. More complicated changes would require clicking on the edit button to bring up the full editor (edit buttons are not shown, except for the spouse).
N.B. This is only a very quick and rough example - it needs to be worked out much more fully.
[[File:Example composite editor.jpg]]
== Make displays editable ==
Improve Help and Documentations in Gramps
* Update [[User_manual|user manual]] to match current (Gramps 4.2.0) version of Gramps(Started:20150701 - Completed: In progress )* {{bug|8888}} : [Review]Gramps Help button User Manual wiki-links (Started:20150904 - Completed: In progress )** Review Gramps code and ensure that {{man key press|F1}} help links as well as {{man button|Help}} buttons link to correct sections on wiki.** Add help buttons where missing** If no {{man button|Help}} button can be shown for the page ensure that pressing {{man key press|F1}} brings the user to the correct page and not just the Manual index eg: correct context.
Know your audience, who is uses this software?* Icons are nice, text labels are better. (no mystery meat navigation) (Add Toolbar text under icons by using patch from {{bug|6583#c44563}})
* Add an help icon to the toolbar eg a question mark '''?''' etc.
=== Roll over of user manual ===
I suggest we change the way this is done so that updating the user manual is in sync with changes in Gramps master.
* The '''Translate extension''' tool to translate every kind of text. It's used especially to translate software and to manage multilingual wikis in a sensible way. https://www.mediawiki.org/wiki/Extension:Translate
Add a Mediawiki instance and new domain for documentation
Be able to cache Offline help files?
*In preferences have a help server URL dropdown with an option for "Offline/local" that point to a local GRAMPS_HELP directory that you can place a spidered html copy of the help. -->
= Minor changes that are NOT the subject of this GEPS =
* Select Child window to open at last used name.
* Improve usability of export assistant filters.
= See also =
* {{bug|8686}} Prototype for a new "Event Entry" window.
* {{bug|1577}} Cumbersome work flow to add more people to an event
* {{bug|7807}} main window makeover (full-screen option)
* {{bug|8099}} Create hard-copy like documentation as PDF (Suggest installing the [https://www.mediawiki.org/wiki/Extension:Collection Mediwiki:Extension:Collection] ''Allows to organize personal selections of pages in a collection that can be edited, persisted and optionally retrieved as PDF, ODF or DocBook (XML)'')
[[Category:GEPS|U]]
