Complete Kotlin Tutorial Documentation

README.md

@@ -3,94 +3,99 @@ Learn Kotlin Programming, its basics and Fundamentals from scratch.
 
 ## Topics to be covered
 0. Overview
-    - Course introduction, prequisites and software required
+    - [Course introduction, prerequisites and software required](docs/00-course-introduction.md)
 1. Installation
-    - Install required softwares for Windows, MAC and Linux ( Ubuntu )
+    - [Install required softwares for Windows, MAC and Linux ( Ubuntu )](docs/installation.md)
 2. Getting Started with Kotlin Programming
-    - Run your first app in Kotlin
+    - [Run your first app in Kotlin](docs/basics/01-hello-world.md)
 3. Exploring Data Types and Variables 
-    - Data Types and Variables
-    - String, Literals and String Interpolation
-    - Comments 
+    - [Data Types and Variables](docs/basics/02-variables-data-types.md)
+    - [String, Literals and String Interpolation](docs/basics/05-string-interpolation.md)
+    - [Comments](docs/basics/03-comments.md)
 4. Constants, Variables and Data Types
+    - [Data Types Deep Dive](docs/basics/04-data-types.md)
 5. Control Flow Statements 
-    - IF ELSE 
-    - IF Expressions
-    - WHEN Expressions
+    - [IF ELSE and IF Expressions](docs/control-flow/01-if-expressions.md)
+    - [WHEN Expressions](docs/control-flow/02-when-expressions.md)
 6. Loop Control Statements 
-    - What are Iterators?
-    - FOR Loop and how it works
-    - WHILE Loop
-    - DO WHILE Loop 
-    - BREAK statements 
-    - CONTINUE keyword 
-    - Labelled FOR Loop 
+    - [What are Iterators?](docs/control-flow/06-iterators.md)
+    - [FOR Loop and how it works](docs/control-flow/03-for-loops.md)
+    - [WHILE Loop](docs/control-flow/04-while-loops.md)
+    - [DO WHILE Loop](docs/control-flow/04-while-loops.md)
+    - [BREAK statements](docs/control-flow/05-break-continue.md)
+    - [CONTINUE keyword](docs/control-flow/05-break-continue.md)
+    - [Labelled FOR Loop](docs/control-flow/07-labelled-loops.md) 
 7. Functions and Interoperability 
-    - Declaring functions 
-    - Interoperability with Java code 
-    - Function as Expressions 
-    - Extension Functions
-    - Infix Functions
-    - Default Parameters
-    - Named Parameters
-    - Tailrec Functions 
+    - [Declaring functions](docs/functions/01-functions-basics.md)
+    - [Interoperability with Java code](docs/advanced/01-kotlin-interoperability.md)
+    - [Function as Expressions](docs/functions/02-functions-as-expressions.md)
+    - [Extension Functions](docs/functions/04-extension-functions.md)
+    - [Infix Functions](docs/functions/05-infix-functions.md)
+    - [Default Parameters](docs/functions/06-default-parameters.md)
+    - [Named Parameters](docs/functions/03-named-parameters.md)
+    - [Tailrec Functions](docs/functions/07-tailrec-functions.md) 
 8. Object Oriented Programming in Kotlin 
-    - Defining Class and creating Objects
-    - INIT block
-    - Primary and Secondary Constructors 
-    - Properties ( Field variables )
-    - Inheritance
-    - Method and Property Overriding 
-    - Polymorphism 
-    - Abstract Class, Property and Method
-    - Interface 
-    - Data Class
-    - Object Declaration
-    - Enum class 
-    - Sealed class
-    - Companion Object
+    - [Defining Class, creating Objects, and Constructors](docs/oop/01-classes-constructors.md)
+    - [INIT block](docs/oop/05-init-block.md)
+    - [Properties ( Field variables )](docs/oop/06-properties.md)
+    - [Inheritance](docs/oop/02-inheritance.md)
+    - [Method and Property Overriding](docs/oop/03-method-overriding.md)
+    - [Polymorphism](docs/oop/08-polymorphism.md)
+    - [Abstract Class, Property and Method](docs/oop/04-abstract-classes.md)
+    - [Interface](docs/oop/09-interface.md)
+    - [Data Class](docs/oop/10-data-class.md)
+    - [Object Declaration](docs/oop/11-object-declaration.md)
+    - [Enum class](docs/oop/07-enums-sealed-classes.md)
+    - [Sealed class](docs/oop/07-enums-sealed-classes.md)
+    - [Companion Object](docs/oop/12-companion-object.md)
 9. Functional Programming in Koltin
-    - Lambdas
-    - Higher-Order Functions
-    - Closures
-    - 'it' keyword
-    - 'with' function
-    - 'apply' function
+    - [Lambdas](docs/functional-programming/01-lambdas.md)
+    - [Higher-Order Functions](docs/functional-programming/05-higher-order-functions.md)
+    - [Closures](docs/functional-programming/06-closures.md)
+    - ['it' keyword](docs/functional-programming/07-it-keyword.md)
+    - ['with' function](docs/functional-programming/02-scope-functions.md)
+    - ['apply' function](docs/functional-programming/02-scope-functions.md)
+    - [let, also, run](docs/functional-programming/03-let-also-run.md)
 10. Collections in Kotlin
-    - Arrays
-    - List
-    - Map and HashMap
-    - Set and HashSet  
+    - [Arrays](docs/collections/01-arrays.md)
+    - [List](docs/collections/02-lists.md)
+    - [Map and HashMap](docs/collections/03-maps.md)
+    - [Set and HashSet](docs/collections/04-sets.md)
 11. Sorting and Filtering
-    - "filter" function
-    - "map" function
-    - Predicates: all, any, find, count. 
+    - ["filter" function](docs/collections/05-filter-map-sorting.md)
+    - ["map" function](docs/collections/05-filter-map-sorting.md)
+    - [Predicates: all, any, find, count](docs/functional-programming/04-predicates.md)
 12. Kotlin NULL Safety
-    - Safe call
-    - with Let
-    - Elvis
-    - Lateinit keyword
-    - Lazy delegation and 'lateinit' vs. 'lazy'
+    - [Safe call](docs/null-safety/01-null-safety.md)
+    - [with Let](docs/null-safety/01-null-safety.md)
+    - [Elvis](docs/null-safety/01-null-safety.md)
+    - [Lateinit keyword](docs/null-safety/02-lateinit-lazy.md)
+    - [Lazy delegation and 'lateinit' vs. 'lazy'](docs/null-safety/02-lateinit-lazy.md)
 13. Scope Functions
-    - with
-    - apply
-    - let
-    - also
-    - run
+    - [with](docs/functional-programming/02-scope-functions.md)
+    - [apply](docs/functional-programming/02-scope-functions.md)
+    - [let](docs/functional-programming/03-let-also-run.md)
+    - [also](docs/functional-programming/03-let-also-run.md)
+    - [run](docs/functional-programming/03-let-also-run.md)
 14. Coroutines
-    - What are Coroutines? How are they related to Threads? 
-    - launch, async, runBlocking, withContext, withTimeoutOrNull, 
-    - Suspending function 
-    - Cancellation and Timeouts 
-    - Cooperative suspending functions and isActive flag
-    - Exception Handling in Coroutines 
-    - Sequential execution of suspending function in Coroutines 
-    - Concurrency within Coroutine 
-    - lazy 'async'
-    - CoroutineScope and CoroutineContext 
-    - Dispacthers: Confined dispatcher, Default Dispatcher, and Unconfined Displatcher 
-15. Conclusion 
+    - [What are Coroutines? How are they related to Threads?](docs/coroutines/01-introduction.md)
+    - [launch, async, runBlocking](docs/coroutines/02-launch-async.md)
+    - [withContext, withTimeoutOrNull](docs/coroutines/04-context-dispatchers.md)
+    - [Suspending function](docs/coroutines/01-introduction.md)
+    - [Cancellation and Timeouts](docs/coroutines/03-exception-handling.md)
+    - [Cooperative suspending functions and isActive flag](docs/coroutines/01-introduction.md)
+    - [Exception Handling in Coroutines](docs/coroutines/03-exception-handling.md)
+    - [Sequential execution of suspending function in Coroutines](docs/coroutines/02-launch-async.md)
+    - [Concurrency within Coroutine](docs/coroutines/02-launch-async.md)
+    - [lazy 'async'](docs/coroutines/02-launch-async.md)
+    - [CoroutineScope and CoroutineContext](docs/coroutines/04-context-dispatchers.md)
+    - [Dispatchers: Confined dispatcher, Default Dispatcher, and Unconfined Dispatcher](docs/coroutines/04-context-dispatchers.md)
+15. [Conclusion](docs/conclusion.md) 
 
 ## Authors 
 
-* **Sriyank Siddhartha** 
+* **Sriyank Siddhartha** - Original creator
+
+## Contributors
+
+* **GPL Gowtham chand** ([@gpl-gowthamchand](https://github.com/gpl-gowthamchand)) - Documentation, explanations, and content organization