Thanks.

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:

...and this:

¯\_(ツ)_/¯

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

I get this screen:

Here's what I see -- step 1:

Step 2:

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:

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:

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?

In T11278#184475, @epriestley wrote:

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.