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.
Revisions and Commits
- Mentioned In
- T11157: ability to disable support for certain VCS
- Mentioned Here
- T10925: Cannot create repository with latest HEAD
rARC4d4d16f25985: Validate Arcanist install-certificate URIs more carefully
rPHUdde2f74f2793: Provide base "Simplified" and "Traditional" Chinese locales
rPb53831101f39: Raise explicit setup issues about PHP 7
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.
I'm leaning toward just adding a big "Clippy" element to this UI:
That is, replace this:
+---+ +---+ +---+ | X | | Y | | Z | +---+ +---+ +---+
+---+ +---+ +---+ | 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?
The configuration guide states
importing repositories with Diffusion User Guide;
which brings me to https://secure.phabricator.com/book/phabricator/article/diffusion/
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?