Difference between revisions of "How you can help"

From Gramps
Jump to: navigation, search
m
(Develop screencasts)
(35 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
{{languages|How you can help}}
 
{{languages|How you can help}}
How can you contribute to GRAMPS?
+
How can you contribute to Gramps?
  
 
==Why we need help==
 
==Why we need help==
We have become victims of our own success. Over the past couple of years, GRAMPS has grown to thousands of users. Demands for support and enhancements are increasing each day. Unfortunately, the development team had not grown in the same manner. This year, over 90% of all commits have been done by five people.
+
We have become victims of our own success. By 2007, the reputation of version 2 had solidified Gramps as a good alternative to commercial genealogy tools. And Gramps suddenly grew to thousands of users. Consequently, demands for support and enhancements kept increasing each day. By 2019, the  downloads of Gramps from GitHub measured downloads in hundreds each month. Unfortunately, the development team does not grow in the same manner.  
  
Forward progress on the project is slowing due to the increasing support load. In order to continue to support the needs of the community, we need additional support.
+
Forward progress on the project is continually restrained by the increasing support load. In order to continue to support the needs of the community, we need additional support.
  
 
==What you can do to help==
 
==What you can do to help==
Below is a list of programming tasks that we need to have accomplished. If you can help, please let us know.
+
Below is a list of programming tasks where we want to increase momentum. If you can contribute in these areas, please let us know.
  
; Improved GEDCOM import and export: It seems that no matter how hard we work at it, there is something that always needs to be improved. If you are a GEDCOM expert contact the developers.
+
===Improved [[:Gramps_and_GEDCOM|GEDCOM]] import and export===
; Resolving bug reports: Bug reports arrive all the time, often several a day. Resolving bug reports is a major way in which you can help the team to be able to spend more time enhancing the system.
+
It seems that no matter how hard we work at [[:Gramps_and_GEDCOM|supporting more GEDCOM attributes]], there is something that always needs to be improved. If you are a GEDCOM expert [[:Contact|contact]] the developers.
; Integrate mapview (openstreetmap, google maps): with those tools available and the locations in GRAMPS there are tons of opportunities.
+
===Resolving bug reports===
; Profiling the application on large datasets, and speed improvements
+
Bug reports arrive all the time, often several a day. Resolving bug reports is a major way in which you can help the team to be able to spend more time enhancing the system. See [[Bug triage]]
; Import data, merging duplicates: if more sources are used and data is imported from those sources, it is sometimes very hard to find duplicate data.  
+
===Profiling the application on large datasets, and speed improvements===
 +
See [[Gramps Performance]] and [[Tips for large databases]]
 +
===Streamline the import of data and merging of duplicates===
 +
if more sources are used and data is imported from those sources, it is sometimes very hard to find duplicate data.
 +
{{man note|Unrivaled Contributing|Gramps is an open source project developed under the [[Howto:_Contribute_to_Gramps|GNU General Public License]] policy. Please protect our project by contributing ethically and within those guidelines.}}
  
==Web 2.0==
+
==But what if I don't know how to program?==
The new buzzword: '''Web2.0'''. Some '''collaboration''' added to GRAMPS would be great obviously. People who build webapplications could certainly help us enormously. The idea is to have a webbased tool that could export .gramps files (independant of GRAMPS or just other developers) and would have the possibility to move back and forth. A sort of import with an automatic merge would be really, really, needed. This is '''the one recurring theme''' in comments on GRAMPS .
+
You don't need to know how to program for your labor to be of great help to the project.
 +
 
 +
===How users can help the Developers===
 +
There are more parts to Gramps than the developer team can stress test. [https://en.m.wikipedia.org/wiki/Software_testing Software testing] is a vital component of any software project. Users can:
 +
====Develop database test cases====
 +
We need sample databases that handle all the features of the program. If possible, expand the [[Example.gramps|example]] data file.
 +
====Help with interface testing====
 +
Either testing the interface by hand, or help writing [https://gitlab.com/dogtail/dogtail dogtail] tests for automated testing.
 +
====Identify problems====
 +
If you encounter a bug, [[Using_the_bug_tracker|file a good Bug Report]].  Filing a unique and; reproducible Bug Report is an enormous help.
 +
 
 +
====Validate aging Bug Reports====
 +
As new releases enhance Gramps and address known problems, it is helpful to confirm old Bug Reports are still be valid. It is best to validate your own Bug Reports first and amend with any new insights.
 +
 
 +
===How users can help other users===
 +
Even absolute novice users have unique insights into the usability of Gramps and the documentation. The idiosyncracies actually become more invisible as workarounds become habitual.
 +
 
 +
Help us identify where the Gramps interface, workflow and; documentation could be more intuitive or flow more naturally.
 +
 
 +
====Write for the Wiki====
 +
Here is where you can make a highly visible contribution to Gramps. If you [[:Special:RequestAccount|request a Wiki Contributor account]], you can help expand our ''most underdeveloped'' user tools.
 +
 
 +
Some specialty documentation:
 +
* [[:Category:How do I...|How I do ...]]
 +
* [[:Category:Tutorials|Tutorials]]
 +
* [[:Category:Tips|Tips]]
 +
* [[:Category:Screencasts|Screencasts]].
 +
 
 +
As a user, you can best explain how you go about its use. And sharing this knowledge is a great thing to do. An interesting side effect of writing documentation is that it causes you learn the features more fully and learn how to take better advantage of them.
 +
 
 +
The more you use Gramps, you will gain more and; more knowledge of the reports, how they work, and how they can be made better. Expanding the [[:Gramps_{{Version manual}}_Wiki_Manual_-_Reports|Reports]] documentation will make the original learning curve less steep for other and easier for you the next time.
 +
 
 +
{{man tip|1=Wiki manual|2=Please enhance the {{man label|Wiki}} - particularly wanted is help [[User_manual_translations|translating and updating]] the [[User manual]] sections.}}
 +
 
 +
====Develop screencasts====
 +
Share how you use Gramps by showing others. [http://www.unixuser.org/~euske/python/vnc2flv/index.html vnc2flv], [http://recordmydesktop.sourceforge.net/ recordmydesktop], [http://www.tortall.net/mu/wiki/Cankiri Cankiri], [https://www.lifewire.com/how-to-capture-a-screencast-using-vlc-2533002 VLC], [http://xvidcap.sourceforge.net/ xvidcap], gifsicle or [http://www.swftools.org/ SWFTools] programs can be used to create screen movies that could be used to show people how to perform different tasks. [http://imagination.sourceforge.net/ Imagination] and [http://www.openshot.org/ OpenShot] could help us to generate a video with some screenshots addition. Also see the list of screencast tools on [http://en.wikipedia.org/wiki/List_of_screencasting_software wikipedia]
  
==But what if I don't know how to program?==
+
Also, [http://en.wikipedia.org/wiki/World_Wide_Web_Consortium W3C] work on specifications for [http://www.w3.org/AudioVideo/ Synchronized Multimedia Integration Language] and video markup for [https://html.spec.whatwg.org/#video HTML5].
Even if you don't know how to program, you can still help out with the project. You can:
+
 
; Develop database test cases: We need sample databases that handle all the features of the program.
+
====Provide a translation====
; Help with interface testing: Either testing the interface by hand, or help writing dogtail tests for automated testing.
+
Gramps supports many languages, but the more languages we support, the more we serve our community. See also [[Portal:Translators| Translators]]
; Write tutorials on wiki: Here is where you can make '''the most valuable contributions'''.
 
As a user you can best explain how you go about and sharing this knowledge is a great thing to do. As a user of GRAMPS, you will gain knowledge of the reports, how they work, and how they can be made better.
 
  
{{man tip|1=Wiki manual|2=Please enhance the {{man label|Wiki}} - particularly the manual section.}}
+
====Package the program for a distribution====
 +
Installing Gramps from source code is more than most new users can handle. If you can provide a package for your system, it will make it easier for new users to starting using Gramps.
  
[[:Category:How_do_I|How I do ...]], [[:Category:Tutorials|Tutorials]], [[:Category:Tips|Tips]], [[:Category:Screencasts]].
+
====Participate on the [[:Contact#Mailing_Lists|mailing lists]]====
; Develop screencasts: [http://www.unixuser.org/~euske/vnc2swf/ vnc2swf], [http://recordmydesktop.sourceforge.net/ recordmydesktop], [http://live.gnome.org/Istanbul Istanbul], [http://www.tortall.net/mu/wiki/Cankiri Cankiri], [http://www.techmag.biz/capturing_screen_VLC_screencasting VLC], [http://xvidcap.sourceforge.net/ xvidcap], gifsicle or [http://www.swftools.org/ SWFTools] programs can be used to create screen movies that could be used to show people how to perform different tasks. [http://imagination.sourceforge.net/ Imagination] and [http://www.openshot.org/ OpenShot] could help us to generate a video with some screenshots addition.
+
If the users of the community can answer each others questions, it can significantly reduce the load on the developers.
Also, [http://en.wikipedia.org/wiki/World_Wide_Web_Consortium W3C] work on specifications for [http://www.w3.org/AudioVideo/ Synchronized Multimedia Integration Language] and a video markup could be added on [http://www.whatwg.org/specs/web-apps/current-work/#video HTML5].
 
; Provide a translation: GRAMPS supports many languages, but the more languages we support, the more we serve our community. See also [[Portal:Translators| Translators]]
 
; Package the program for a distribution: Installing GRAMPS from source code is more than most new users can handle. If you can provide a package for your system, it will make it easier for new users to starting using GRAMPS.
 
; Participate on the [[:Contact#Mailing_Lists|mailing lists]]: If the users of the community can answer each others questions, it can significantly reduce the load on the developers.
 
  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]
 +
[[Category:How_do_I...|How can I help?]]
 +
[[Category:Screencasts]]

Revision as of 02:00, 16 June 2020

How can you contribute to Gramps?

Why we need help

We have become victims of our own success. By 2007, the reputation of version 2 had solidified Gramps as a good alternative to commercial genealogy tools. And Gramps suddenly grew to thousands of users. Consequently, demands for support and enhancements kept increasing each day. By 2019, the downloads of Gramps from GitHub measured downloads in hundreds each month. Unfortunately, the development team does not grow in the same manner.

Forward progress on the project is continually restrained by the increasing support load. In order to continue to support the needs of the community, we need additional support.

What you can do to help

Below is a list of programming tasks where we want to increase momentum. If you can contribute in these areas, please let us know.

Improved GEDCOM import and export

It seems that no matter how hard we work at supporting more GEDCOM attributes, there is something that always needs to be improved. If you are a GEDCOM expert contact the developers.

Resolving bug reports

Bug reports arrive all the time, often several a day. Resolving bug reports is a major way in which you can help the team to be able to spend more time enhancing the system. See Bug triage

Profiling the application on large datasets, and speed improvements

See Gramps Performance and Tips for large databases

Streamline the import of data and merging of duplicates

if more sources are used and data is imported from those sources, it is sometimes very hard to find duplicate data.

Gramps-notes.png
Unrivaled Contributing

Gramps is an open source project developed under the GNU General Public License policy. Please protect our project by contributing ethically and within those guidelines.

But what if I don't know how to program?

You don't need to know how to program for your labor to be of great help to the project.

How users can help the Developers

There are more parts to Gramps than the developer team can stress test. Software testing is a vital component of any software project. Users can:

Develop database test cases

We need sample databases that handle all the features of the program. If possible, expand the example data file.

Help with interface testing

Either testing the interface by hand, or help writing dogtail tests for automated testing.

Identify problems

If you encounter a bug, file a good Bug Report. Filing a unique and; reproducible Bug Report is an enormous help.

Validate aging Bug Reports

As new releases enhance Gramps and address known problems, it is helpful to confirm old Bug Reports are still be valid. It is best to validate your own Bug Reports first and amend with any new insights.

How users can help other users

Even absolute novice users have unique insights into the usability of Gramps and the documentation. The idiosyncracies actually become more invisible as workarounds become habitual.

Help us identify where the Gramps interface, workflow and; documentation could be more intuitive or flow more naturally.

Write for the Wiki

Here is where you can make a highly visible contribution to Gramps. If you request a Wiki Contributor account, you can help expand our most underdeveloped user tools.

Some specialty documentation:

As a user, you can best explain how you go about its use. And sharing this knowledge is a great thing to do. An interesting side effect of writing documentation is that it causes you learn the features more fully and learn how to take better advantage of them.

The more you use Gramps, you will gain more and; more knowledge of the reports, how they work, and how they can be made better. Expanding the Reports documentation will make the original learning curve less steep for other and easier for you the next time.

Tango-Dialog-information.png
Wiki manual

Please enhance the Wiki - particularly wanted is help translating and updating the User manual sections.


Develop screencasts

Share how you use Gramps by showing others. vnc2flv, recordmydesktop, Cankiri, VLC, xvidcap, gifsicle or SWFTools programs can be used to create screen movies that could be used to show people how to perform different tasks. Imagination and OpenShot could help us to generate a video with some screenshots addition. Also see the list of screencast tools on wikipedia

Also, W3C work on specifications for Synchronized Multimedia Integration Language and video markup for HTML5.

Provide a translation

Gramps supports many languages, but the more languages we support, the more we serve our community. See also Translators

Package the program for a distribution

Installing Gramps from source code is more than most new users can handle. If you can provide a package for your system, it will make it easier for new users to starting using Gramps.

Participate on the mailing lists

If the users of the community can answer each others questions, it can significantly reduce the load on the developers.