Page MenuHomePhabricator

It's confusing to figure out in the UI how to import a repository now
Closed, ResolvedPublic

Description

Since the Diffusion / Repository overhaul in May? users are not easily figuring out how to import a repository into Phabricator. GitHub/Gitlab make this reasonably obvious. I don't think we even mention "Import" anywhere in the UI, you need to find it in the Diffusion URI documentation.

Event Timeline

chad renamed this task from Can no longer find 'import from existing repository' to It's confusing to figure out in the UI how to import a repository now.Jul 6 2016, 1:51 AM
chad reopened this task as Open.
chad updated the task description. (Show Details)
chad edited projects, added Diffusion, Design; removed Diffusion (v3), Bug Report.

People keep getting stuck on this, so we should look at fixing the UI so we don't have to post the documentation over and over.

GitHub make this reasonably obvious.

I'm pretty sure this isn't possible in GitHub. Can you walk me through how GitHub makes this obvious?

Oh, I was looking at this:

Screen Shot 2016-07-05 at 7.00.52 PM.png (121×388 px, 13 KB)

...and this:

Screen Shot 2016-07-05 at 7.00.57 PM.png (143×210 px, 8 KB)

¯\_(ツ)_/¯

GitHub's import doesn't seem to work with any repositories that require credentials?

Screen Shot 2016-07-05 at 7.03.16 PM.png (115×685 px, 17 KB)

Here's what I see -- step 1:

Screen Shot 2016-07-05 at 7.27.30 PM.png (566×607 px, 64 KB)

Step 2:

Screen Shot 2016-07-05 at 7.27.36 PM.png (1×1 px, 139 KB)

Maybe HTTP works OK but not SSH.

yeah doesn't import ssh from what I see and they just say to use the command-line importer if you can't use the web tool

I was confused at first - from previous workflow I thought I took a wrong step when setting up the repository and landed on a "completed" repository page which I didn't expect without selecting host vs. mirror. I deleted the repository and started again and finally got it after hours of turmoil (maybe more like a minute of prodding).

Another issue is that when following the user docs, the docs still points towards having the import button on the creation of project. I was pretty confused as it clearly wasn't that. Perhaps the page after clicking the 'Create Repository' could have an option of importing, which presets the values to observe a repo.

We can probably start with a text hint on this view:

pasted_file (465×923 px, 90 KB)

Is that text already present and I just missed it?

Yeah, I think it goes away after you push "activate"

I think if you haven't activated the repository and visit URIs, we can show an "Import" type note and call it a day for now.

I'm leaning toward just adding a big "Clippy" element to this UI:

Screen Shot 2016-07-06 at 4.28.23 PM.png (886×1 px, 120 KB)

That is, replace this:

+---+ +---+ +---+ 
| X | | Y | | Z | 
+---+ +---+ +---+

...with this:

+---+ +---+ +---+ 
| X | | Y | | Z | 
+---+ +---+ +---+ 
+---------------------------------------+
| Want to import a repository?          |
| Click here to read the documentation! |
+---------------------------------------+

I think (?) that a lot of the confusion has been from users who had previously gone through the old workflow and aren't making it to the hinting, maybe? Or the hinting is nearly useless and we should possibly just get rid of it.

Another issue is that when following the user docs, the docs still points towards having the import button on the creation of project.

I can't find where we say this in the documentation. Can you point me at what you're seeing?

Another issue is that when following the user docs, the docs still points towards having the import button on the creation of project.

I can't find where we say this in the documentation. Can you point me at what you're seeing?

The configuration guide states

importing repositories with Diffusion User Guide;

which brings me to https://secure.phabricator.com/book/phabricator/article/diffusion/

which shows

Repository administration is accomplished through Diffusion. You can use the web interface in Diffusion to observe an external repository or create a new hosted repository.

That is basically it when it comes to educating new users about the abilities to import a repository. The URI docs are not mention at all on any of these three pages. That was mainly why I did not know about it.

Okay, but the docs don't actually describe or refer to an import button anywhere -- there's no text like "click the import button" that I missed when updating things?

They only refer to it sort of subjectively/indirectly if you happen to know that there used to be an explicit modal choice between importing and hosting?

You are right, it does not specifically describe or refer to an import button anywhere.

Yes for the second part from my understanding of the docs.