Contributions are welcome and are greatly appreciated! Every little bit helps, and credit will always be given.
Table of Contents
Report bugs through Github issue.
Please report relevant information and preferably code that exhibits the problem.
Look through the Github issue for bugs. Anything is open to whoever wants to implement it.
Look through the Github issue or Malaya-project for features. Any unassigned improvement issue is open to whoever wants to implement it.
Remember, 100% Tensorflow (version 1.10 and above, not 2.0, yet), no Keras.
Create a new issue in Github issue related to your data including the data link or attached it there. If you want to improve current dataset we have, you can check at Malaya-Dataset.
Or, you can simply email your data if you do not want to expose the data to public. Malaya will not exposed your data, but we will exposed our trained models based on your data.
Thanks to,
- Fake news, contributed by syazanihussin
- Speech voice, contributed by Khalil Nooh
- Speech voice, contributed by Mas Aisyah Ahmad
- Singlish text dump, contributed by brytjy
- Singapore news, contributed by brytjy
Malaya could always use better documentation, might have some typos or uncorrect object names.
The best way to send feedback is to open an issue on Github issue.
Test every possible program flow! You can check unit tests here.
The latest API documentation is usually available here. To generate a local version,
pip install readthedocs
cd docs
bash generate_template.sh
When you develop Malaya you can create local virtualenv with all requirements required by Malaya.
Advantage of local installation is that everything works locally, you do not have to enter Docker/container environment and you can easily debug the code locally. You can also have access to python virtualenv that contains all the necessary requirements and use it in your local IDE - this aids autocompletion, and running tests directly from within the IDE.
The disadvantage is that you have to maintain your dependencies and local environment consistent with other development environments that you have on your local machine.
It's also very difficult to make sure that your local environment is consistent with other environments. This can often lead to "works for me" syndrome. It's better to use the Docker Compose integration test environment in case you want reproducible environment consistent with other people.
Install Python (3.6 and above) by using system-level package managers like yum, apt-get for Linux, or Homebrew for Mac OS at first.
Before you submit a pull request from your forked repo, check that it meets these guidelines:
- The pull request should include step-by-step if the request is
improvement. - Please rebase your fork, squash commits, and resolve all conflicts.
- The pull request should work for Python 3.6 and above.
- As Malaya grows as a project, we try to enforce a more consistent style and try to follow the Python community guidelines. We currently enforce to use BlackMamba for code standard.