-
Notifications
You must be signed in to change notification settings - Fork 8
/
Copy pathCONTRIBUTING.rakudoc
38 lines (25 loc) · 1.3 KB
/
CONTRIBUTING.rakudoc
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
=begin pod
=head1 Contributing
=head2 New language
New languages are always welcome!
To contribute a new language, do the following:
=item Fork this project on Github.
=item Do NOT change Markdown which is auto-generated from Rakudoc files
in thr './docs' directory. Make any changes in the Rakudoc source files there.
=item Determine the ISO two- or three-letter code for your language. You will
use the lower-case version of it in the rest of the steps.
See a list of ISO language codes here:
L<ISO 639-2 alpha 2 language codes|https://www.loc.gov/standards/iso639-2/php/code_list.php>.
=item Copy the template file './resources/xx.rakumod' and rename it to
'lib/Data/Names/xx.rakumod' where xx is your language's lower-case ISO
two- or three-letter code.
=item Fill out the new 'x.rakumod' file as completely as you can. Please
feel free to document it as required, but DO NOT change the name or
number of elements of any of the standard eight arrays.
=item Add your new language code to C<@Date::Names::langs>
(in its place by alphabetical order).
=item Add your new language as a new line in the META6.json in the "provides" array.
Watch comma placement, and ensure the META6.json is valid (requires module
App::Mi6: C<$ mi6 build>).
=item Submit a pull request with your changes.
=end pod