|
Line 0
Link Here
|
| 0 |
- |
1 |
=encoding utf8 |
|
|
2 |
|
| 3 |
=head1 NAME |
| 4 |
|
| 5 |
Koha::Contributing - The Koha Guide to the contributing to the worlds greatest open source library management system |
| 6 |
|
| 7 |
=head1 BASICS |
| 8 |
|
| 9 |
=head2 Learning Perl |
| 10 |
|
| 11 |
If you are new to Perl, we recommend L<Learn Perl in 2 hours 30 minutes|https://qntm.org/perl_en> for a quick |
| 12 |
introduction, or the L<Modern Perl book|https://pragprog.com/book/swperl/modern-perl-fourth-edition>, freely available |
| 13 |
in many formats. Both are excellent introductions to the language. For more books and documentation, check out |
| 14 |
L<learn.perl.org|https://learn.perl.org/>. |
| 15 |
|
| 16 |
=head2 Learning Web Technologies |
| 17 |
|
| 18 |
All web development starts with HTML, CSS and JavaScript, to learn the basics we recommend the L<Mozilla Developer |
| 19 |
Network|https://developer.mozilla.org/en-US/docs/Web>. And if you want to know more about how browsers and web servers |
| 20 |
actually communicate, there's also a very nice introduction to |
| 21 |
L<HTTP|https://developer.mozilla.org/en-US/docs/Web/HTTP>. |
| 22 |
|
| 23 |
=head1 DON'T PANIC! |
| 24 |
|
| 25 |
The L<Koha Community|https://koha-community.org> are a friendly group and always welcoming to new contributors. |
| 26 |
|
| 27 |
=head1 CONVENTIONS |
| 28 |
|
| 29 |
=head2 Modern Perl |
| 30 |
|
| 31 |
L<Mojolicious> uses a modern subset of Perl exclusively, and therefore all documentation assumes that L<strict>, |
| 32 |
L<warnings>, L<utf8> and Perl 5.16 L<features|feature> are enabled, even if examples don't specifically mention it. |
| 33 |
|
| 34 |
use strict; |
| 35 |
use warnings; |
| 36 |
use utf8; |
| 37 |
use feature ':5.16'; |
| 38 |
|
| 39 |
Some modules, like L<Mojo::Base> and L<Mojolicious::Lite>, will enable them for you automatically, whenever they are |
| 40 |
used. |
| 41 |
|
| 42 |
=head2 Coding guidelines |
| 43 |
|
| 44 |
=head1 MODULES |
| 45 |
|
| 46 |
This is the class hierarchy of the L<Koha> ILS. |
| 47 |
|
| 48 |
=over 2 |
| 49 |
|
| 50 |
=item * L<Koha> |
| 51 |
|
| 52 |
=item * L<Koha::Account> |
| 53 |
|
| 54 |
=over 2 |
| 55 |
|
| 56 |
=item * L<Koha::Account::Credit> |
| 57 |
|
| 58 |
=item * L<Koha::Account::Credits> |
| 59 |
|
| 60 |
=item * L<Koha::Account::Debit> |
| 61 |
|
| 62 |
=item * L<Koha::Account::Debits> |
| 63 |
|
| 64 |
=back |
| 65 |
|
| 66 |
=back |
| 67 |
|
| 68 |
=head1 MORE |
| 69 |
|
| 70 |
A lot more documentation and examples by many different authors can be found in the L<Koha |
| 71 |
wiki|https://wiki.koha-community.org>. |
| 72 |
|
| 73 |
=head1 SUPPORT |
| 74 |
|
| 75 |
If you have any questions the documentation might not yet answer, don't hesitate to ask on |
| 76 |
L<Matrix|https://app.element.io/#/room/#koha-community:matrix.org>. |
| 77 |
|
| 78 |
=cut |