•  
      request #10421 Better Tuleap defaults for new comers
    Infos
    #10421
    Manuel Vacelet (vaceletm)
    2017-10-26 16:55
    2017-07-07 11:16
    10665
    Details
    Better Tuleap defaults for new comers

    Default tuleap configuration is not very welcoming for new users, there are a couple of things that needs to be fixed:

    • Default documentation and help pages
    • Default templates shipped to end users
    • Default settings in local.inc
    Installation process
    Empty
    Empty
    • [x] enhancement
    • [ ] internal improvement
    Empty
    Stage
    Empty
    New
    Empty
    Attachments
    Empty
    References

    Follow-ups

    User avatar

    Ok, now that we have a less crappy Project map, let's discuss the next steps:

    • Having the widget instanciated by default
    • Make the sentence "create / join" dependent of the platform + links
    • Add the "Contact administrator widget modal" in Project map to "ask to join this project"

    We also discussed with @mmidy about the rewrite and transfer of Create your first project tutorial on tuleap.org. The current process is quite long and require a site administrator so I was wondering about having projects auto approved by default on all new instance.

    What do you think ?

     

    User avatar
    I don't think that one bullet about how to "join a project" invalidates the whole widget. Since we are not in a hurry, what about mentioning "join a project" only when we have a decent software map?

    BTW, the widget seems to not be instantiated by default for new instances.
    User avatar

    I don't know what @nterray think about that but from my POV we are not in a (f)hurry there, we need to have a better answer when the release is out but we can take the time to discuss the strategy. I'll propose a short discussion to sort this out later this week.

    User avatar

    I forgot my own development here...

    As an alternative (to removal), would it be acceptable to point ppl toward a less crappy version of the software map (see gerrit #9357) maybe with a "ask to join" button ?

    User avatar

    It's a beautiful example of non decision :)

    What I understand is that we cannot have a good welcome message for new mere mortal comers so far so the entire widget should be removed, at least for regular users. Shall I revert my patch or do you think we can keep the one for site admin ?

    User avatar

    Regarding the create project question, I understand that create a project might not be the first step we want users do. However, regarding the join project question :

    • either we lead the user to the software map because it's the only way to "discover" public projects, even if they can't "join" them (they can only go in a project and see open data)
    • or we don't want to lead the user to the software map but in this case, we can't say in the welcome message "your next step is to join a project"

     

    User avatar

    * h1 title is too big
    * h1 title is redundant with widget name, it can be removed

    Ok

     One doesn't know how to join a project or create one

    In the first version the text was longer but I didn't find a way to keep it short (to be read). Esp. because there are no easy way to join a project as of today (except redirecting to software map and it's unlikely that we want to point people there ATM. Create a project might be easier but I'm not sure it's really what we want for all new users (compare to site admin).

    So we can wonder why do we write that as first step ?

    Because it's really what people should do :/

    It does not respect `sys_use_project_registration` config

    It's on purpose and it's why I bothered dealing with site-content overloading.

    Not only it doesn't respect this setting but it doesn't respect any policies that might have been set (explicitely or not) about project creation and usage (for instance the default message might be different for Restricted users too).

    If admins doesn't like the default message, they can overload with there own text.

    This contrib is part of a bigger picture to better jump start for new comers that install Tuleap first time (with some defaults that are assumed as already set by us). For platforms that are there since ages, they will have to adapt the text.

    French sentence "AcmeForge est le nom interne Acme Corporation de Tuleap" is weird. I suggest: "AcmeForge est le nom interne de Tuleap au sein de Acme Corporation"
    For site admins, the widget does not display the same information for English and French users

    Will fix it

    User avatar
    There are some UX issues introduced in gerrit #8938:

    * h1 title is too big
    * h1 title is redundant with widget name, it can be removed
    * One doesn't know how to join a project or create one
    * It does not respect `sys_use_project_registration` config
    * French sentence "AcmeForge est le nom interne Acme Corporation de Tuleap" is weird. I suggest: "AcmeForge est le nom interne de Tuleap au sein de Acme Corporation"
    * For site admins, the widget does not display the same information for English and French users
    * Maybe other glitches I cannot see, UX team would be helpful on this subject.