By opening a pull request to this repository, you agree to provide your work under the project license. Also, you agree to grant such license of your work as is required for the purposes of future print editions to @DrBoolean. Should your changes appear in a printed edition, you'll be included in the contributors list.
Errata and basic clarifications will be accepted if we agree that they improve the content. You can also open an issue so we can figure out how or if it needs to be addressed. If you've never done this before, the flow guide might be useful.
Please, have a look at the FAQ before you open an issue. Your question may already have been answered. Should you still need to ask something? Feel free to open an issue and to explain yourself.
Translations to other languages are highly encouraged. Each official translation will be held as a separate repository in the MostlyAdequate organization and linked from the English version book. Since each translation is a different repository, we can also have different maintainers for each project.
In order to create a new translation, you need to follow these steps:
- Fork the main repo.
- Add yourself to the watch list of the main repo, to keep up with changes.
- When translating chapters, create NEW files with suffix of your language.
- For example, Spanish tranlation for
ch01.md
will be onch01-es.md
.
- For example, Spanish tranlation for
- Open a new issue and ask to be part of the organization.
- Transfer the repo to the organization.
- Merge new content from the main repo.
- keep translating...
- Rinse/repeat last two steps until the book is done.