Over the past several days, the topic of documentation has been coming
up. Kevin Godby has offered to help write some documentation based off
of information that I provide. I decided to post to the list, so that
others can make comments as well. Please forgive my poor writing style.
Sources are used to provide information as to where a piece of
information came from. A source is typically something like a book, a
birth, death, or marriage certificate, or a census report. A GRAMPS
Source will contain information about the source, including a Title, the
Author, and general publication information. A GRAMPS source also allows
you to attach a text note, and any number of media objects (such as a
image scan of a page or document). The same source can be attached to
multiple pieces of data.
When a source is attached to a piece of data (such as an event,
attribute, or name), you are creating a source reference. Each source
reference links to a source, and allows you to attach more specific
information. This information includes:
1) Confidence - indicates your confidence in the source. For example,
if your source is Aunt Martha, who thinks she remembers someone's
birthday, it would have a lower confidence level than if you had
a copy of the birth certificate.
2) Volume/Film/Page - Allows you to provide more specific information.
If your source is the "Smith Family" book, the reference can include
the page number where the supporting information resides. You may
100 people in the "Smith Family" book with each person using the
source. This way, each person can be linked to the source, and you
can provide a custom information specific to each reference here.
3) Date - provides a date when you got the information, or when the
information was recorded.
4) Text - allows you to insert a quote from the source in the reference.
This is handy when you don't have a copy of the source.
5) Comments - a place for you to add your own comments.
Each piece of data that supports sources (like an event) may have
multiple sources attached to it. Currently, GRAMPS assumes that the
first source in its list is the primary source. There is not a way to
reorder these yet, but that will happen.
Each item that supports sources will have a 'Sources' tab on the items'
editor (as of the unreleased 0.8.0). This tab will list all source
references attached to the item.