SignUp process

[ksokolic]

Users will have to register to get access to Mantil early beta CLI. Registration is done in three steps: first, they need to answer a short survey and leave us their e-mail, then activation token is sent to their email and it has to be entered in terminal to confirm activation.

A few things need to be done to complete signup implementation:

CLI communication:

• [x] commands register and activate should become subcommands for mantil user
• [x] help text should be updated
• [ ] outputs should be adjusted

Email text:

• [x] In survey user enters his name, it would be great if we could start email with Hi [name]

All texts are prepared in GoogleDocs.

[ianic]

Happy path:

/tmp/excuses ➜ mantil new space
Error: Mantil is not activated. Run ‘mantil user register’ to initiate the signup process
/tmp/excuses ➜ mantil user register
1/4 First things first, what is your name?: ianic
2/4 And your email address?: ianic@mantil.com
✔ Software Engineer
✔ 2-10
Activation token is sent to ianic@mantil.com. Please check your email to finalize registration.
/tmp/excuses took 9s ➜ mantil user activate 1Xo2XORiTwGgkUd13gzc_w
Activation successful. Enjoy building with Mantil!
/tmp/excuses ➜

Help:

/tmp/excuses ➜ mantil user --help
Manages Mantil registration

Mantil is in early beta and access is granted only to registered users. To
register you will be asked to provide your email address where the activation
token will be sent.

USAGE
  mantil user [command]

COMMANDS
  activate    Finalizes Mantil registration
  register    Initiates Mantil registration

  Use "mantil user [command] --help" for more information about a command.

GLOBAL OPTIONS
      --help       Show command help
      --no-color   Don't use colors in output

LEARN MORE
  Visit https://team.mantil.com/docs/ to learn more.
  For further support contact us at support@mantil.com.

/tmp/excuses ➜ mantil user register --help
Mantil is in early beta and access is granted only to registered users. This
command initiates the signup process for Mantil application.

USAGE
  mantil user register

GLOBAL OPTIONS
      --help       Show command help
      --no-color   Don't use colors in output

LEARN MORE
  Visit https://team.mantil.com/docs/ to learn more.
  For further support contact us at support@mantil.com.

/tmp/excuses ➜ mantil user activate --help
Mantil is in early beta and access is granted only to registered users. With the
activation token received in your email this command finalizes Mantil
registration.

USAGE
  mantil user activate <activation-token>

GLOBAL OPTIONS
      --help       Show command help
      --no-color   Don't use colors in output

LEARN MORE
  Visit https://team.mantil.com/docs/ to learn more.
  For further support contact us at support@mantil.com.

[ianic]

E sad vezano uz Error: nisam do kraja postovao. Ostavio sam samo Error:

Naime ovaj 'Please try again or contact us at support@mantil.com for assistance.' stoji samo u slucaju kada je neka prolazna greska na nasoj strani. Ako je fulao token, try again mu nece pomoci.

Kada iz cli posalje na nas backend activation request, trenutno su moguci odgovori:

• bad request
• internal server error
• activation token not found
• token already used on another machine

Prvi je zapravo nemoguc ako radi kroz cli. To bi mogao dobiti ako posalje lose formatiran request, a to cli nece napraviti. Drugi je kada nam se raspadne nesto u backendu, npr ne mogu doci do DynamoDB, tu je ok da pokusa ponovo. Treci je kada je posalo token koji nemamo u bazi. Cetvrti kada je vec prosao aktivatciju tim tokenom, ali na drugom racunalu.

[ksokolic]

Vezano uz error, razmišljala sam i ja ima li smisla uputiti ga da pokuša ponovno. Ali ovo su prve komande koje korisnik unosi, svakako želim da dođe do aktivacije Mantila ako je već pokazao interes i krenuo u to. Htjela sam mu dati put za dalje ako naiđe na problem (mail na koji nam se može obratiti). Shvaćam da ti s druge strane rješavaš slučaj kada korisnik pokušava upisati nešto bezeveze ili se registrirati na drugom/više računala. Tada mu ne treba naša pomoć, treba mu dati do znanja da mu to neće proći.

Neka ostane za sada kako si napravio. Pratit ćemo koliko se često taj error događa pa ćemo vidjeti ima li potrebe za dodatnom razradom errora. Iako ne znamo o kojem mailu se radi (ako nije već prošao registraciju) imat ćemo mailove onih koji su inicirali registraciju a nisu je završili pa ćemo na drugi način povezati informacije (tj pitat ćemo te korisnike gdje su zapeli).