Difference between revisions of "Task ideas for Google Code-in/Getting started"
Firespeaker (talk | contribs) |
Firespeaker (talk | contribs) m (→First steps) |
||
Line 4: | Line 4: | ||
So, what are the first steps ? |
So, what are the first steps ? |
||
* '''[[IRC|Talk to us]]''' This is the most important! Nothing in Apertium is too hard without the right amount of help. And we like helping, so just get in contact. The best way to contact us is on [[IRC]], and the best way to use IRC is with a client like irssi,<ref>https://irssi.org/</ref> weechat<ref>https://weechat.org/</ref> or hexchat.<ref>https://hexchat.github.io/</ref>. A good tip is to hang out on IRC, even if no-one is talking when you enter. People can be in different time zones, and channel activity peaks depending on the time. |
* '''[[IRC|Talk to us!]]''' This is the most important step! Nothing in Apertium is too hard without the right amount of help. And we like helping, so just get in contact. The best way to contact us is on [[IRC]], and the best way to use IRC is with a client like irssi,<ref>https://irssi.org/</ref> weechat<ref>https://weechat.org/</ref> or hexchat.<ref>https://hexchat.github.io/</ref>. A good tip is to hang out on IRC, even if no-one is talking when you enter. People can be in different time zones, and channel activity peaks depending on the time. |
||
* '''[[Installation|Install Apertium]]:''' Not all tasks require Apertium to be installed, but if you're planning to work with Apertium, it's a good idea to do this early. |
* '''[[Installation|Install Apertium]]:''' Not all tasks require Apertium to be installed, but if you're planning to work with Apertium, it's a good idea to do this early. |
Revision as of 03:00, 8 November 2016
This page will describe some steps you can take to get involved with the Apertium project in the Google Code-in. First of all, thanks for reading! We're very enthusiastic about getting new contributors to Apertium and to helping spread our passion for language technology.
Contents
First steps
So, what are the first steps ?
- Talk to us! This is the most important step! Nothing in Apertium is too hard without the right amount of help. And we like helping, so just get in contact. The best way to contact us is on IRC, and the best way to use IRC is with a client like irssi,[1] weechat[2] or hexchat.[3]. A good tip is to hang out on IRC, even if no-one is talking when you enter. People can be in different time zones, and channel activity peaks depending on the time.
- Install Apertium: Not all tasks require Apertium to be installed, but if you're planning to work with Apertium, it's a good idea to do this early.
- Find an interesting task:
Useful guidelines
Things you might want to know.
Access
For some tasks, you may need access to Apertium resources, like the wiki or our subversion repository. Usually this is no problem—you just need ask a mentor or an org admin (ask on IRC above).
Tasks on github
For tasks relating to code on github (e.g., begiak, APy, and html-tools), you just need to clone the relevant repository, make your changes, and submit a pull request.
"Fix any bug" tasks
For tasks that point you at a repository and ask you to fix any bug, you should decide on a bug and tell your mentor which one you want to work on when you claim the task. You are also encouraged to come onto IRC (see above) and ask which bug might be a good one to work on given your background—i.e., discussing it with a mentor ahead of time.
Where is apertium code?
Apertium code is housed in several places:
- Most code, including the core tools, translation and language modules, and a number of other things, live in our svn repo. The language data is found in the following places:
- /languages - where stable monolingual language packages live
- /incubator - where the initial stages of language data development takes place, and sometimes stagnates
- /nursery - where translation modules that have begun to become useful/usable live
- /staging - where translation modules that are nearly ready—but are still not quite ready for production-environment use—live
- /trunk - where translation modules that are fully developed and considered stable live; also here is the main code base, etc.
- Several tools live on github, including begiak (our IRC bot), APy (our web API), and html-tools (our website framework). The latter two of these are synchronised back into SVN, but the main development occurs on github.
Language and translation modules
- Most translation modules are structured in the form of apertium-xxx-yyy, meaning it's a module that translates from language xxx to langauge yyy (and potentially the other way around).
- Some older language modules use two letter abbreviations, like apertium-xx-yy, but the standard now is three-letter
- Monolingual language modules are named apertium-xxx, where xxx is the ISO 639-3 code for the language
- All but some older translation modules rely on monolingual language modules