A guide to learn Kotlin from scratch, part of the 4noobs initiative, in Portuguese
and English, published at gustavofreze.github.io/kotlin4noobs. The
notes are the Markdown files under doc/readmes/, read the same way on GitHub and on the site, which adds search and
runs the examples in the page.
| Group | Topic | Portuguese | English |
|---|---|---|---|
| Environment setup | Linux | Português | English |
| Principles | Variables | Português | English |
| Principles | Data types | Português | English |
| Principles | Functions | Português | English |
| Principles | Operators | Português | English |
| Principles | Conditional expressions | Português | English |
| Principles | Loops | Português | English |
| Principles | Scope functions | Português | English |
| Data structures | Collections | Português | English |
| Data structures | Classes and objects | Português | English |
| Data structures | Generics | Português | English |
| Error handling | Exceptions | Português | English |
| Error handling | Null safety | Português | English |
| Asynchronous programming | Coroutines | Português | English |
| Best practices | Coding conventions | Português | English |
Every Kotlin block with a fun main is a runnable example. On the site it runs in place on the
Kotlin Playground, on the latest stable version of Kotlin. The Validate examples
workflow compiles and runs every example on that same version on each pull request that changes the notes and on the
first day of every month. The monthly run also checks for a newer Kotlin Playground, and opens an issue saying what to
change when either check fails.
| Resource | Link |
|---|---|
| IntelliJ IDEA | Link |
| Kotlin Playground | Link |
| Kotlin POCs | Link |
| Brazilian companies using Kotlin | Link |
To clone the repository using the command line, run:
git clone https://github.com/gustavofreze/kotlin4noobs.gitTo install project dependencies locally, run:
make configureTo start the development server with live reload, run:
make startTo stop the development server, run:
make stopTo build the site and its search index into dist/, run:
make buildTo serve the built site, search included, as it is published, run:
make previewRun the unit tests:
make testsCheck the script every built page ships against its budget (run after make build):
make budgetsRun the linter, the formatter check and the Astro and TypeScript checks:
make reviewFix linter and formatter issues:
make fix-reviewCompile and run every example of the notes on the latest stable Kotlin of the Playground:
make examplesRemove dependencies and generated artifacts:
make cleanYou can check other available commands by running
make help.
| Environment | URL |
|---|---|
Local |
http://localhost:4321/kotlin4noobs/ |
Production |
https://gustavofreze.github.io/kotlin4noobs |
The CD (Deploy site) workflow builds the site and publishes it on GitHub Pages. It runs on demand from the Actions tab.
Follow the contribution guidelines to contribute to the project.