Login screens: add some doc

vector/src/main/java/im/vector/riotx/features/login/LoginFragment.kt

@@ -32,11 +32,12 @@ import kotlinx.android.synthetic.main.fragment_login.*
 import javax.inject.Inject
 
 /**
- * What can be improved:
- * - When filtering more (when entering new chars), we could filter on result we already have, during the new server request, to avoid empty screen effect
+ * In this screen, the user is asked for login and password to sign in to a homeserver.
+ * He also can reset his password
  */
 class LoginFragment @Inject constructor() : AbstractLoginFragment() {
 
+    // TODO Move to viewState?
     private var passwordShown = false
 
     override fun getLayoutResId() = R.layout.fragment_login

vector/src/main/java/im/vector/riotx/features/login/LoginServerSelectionFragment.kt

@@ -27,7 +27,7 @@ import me.gujun.android.span.span
 import javax.inject.Inject
 
 /**
- *
+ * In this screen, the user will choose between matrix.org, modular or other type of homeserver
  */
 class LoginServerSelectionFragment @Inject constructor() : AbstractLoginFragment() {
 

vector/src/main/java/im/vector/riotx/features/login/LoginServerUrlFormFragment.kt

@@ -31,7 +31,7 @@ import kotlinx.android.synthetic.main.fragment_login_server_url_form.*
 import javax.inject.Inject
 
 /**
- *
+ * In this screen, the user is prompted to enter a homeserver url
  */
 class LoginServerUrlFormFragment @Inject constructor(
         private val errorFormatter: ErrorFormatter

vector/src/main/java/im/vector/riotx/features/login/LoginSignUpSignInSelectionFragment.kt

@@ -24,7 +24,7 @@ import kotlinx.android.synthetic.main.fragment_login_signup_signin_selection.*
 import javax.inject.Inject
 
 /**
- *
+ * In this screen, the user is asked to sign up or to sign in to the homeserver
  */
 class LoginSignUpSignInSelectionFragment @Inject constructor() : AbstractLoginFragment() {
 

vector/src/main/java/im/vector/riotx/features/login/LoginSplashFragment.kt

@@ -21,7 +21,7 @@ import im.vector.riotx.R
 import javax.inject.Inject
 
 /**
- *
+ * In this screen, the user is viewing an introduction to what he can do with this application
  */
 class LoginSplashFragment @Inject constructor() : AbstractLoginFragment() {