User can't find "Push an existing folder" instructions
@dnsmichi pointed me to https://forum.gitlab.com/t/push-an-existing-folder/56784 where a user was having trouble finding the “Push an existing folder” instructions. I reconstructed the workflow, and confirmed -- the docs are incomplete here, and our UX could probably be better.
Problem to solve
When creating a new project, the user must know to deselect Initialize repository with a README to create a fully empty repository. If the repository is completely empty, we show instructions for how to push items up into the repo. If the user leaves the default options unchanged, the repo isn't empty and the information doesn't appear.
Likely a docs fix, and maybe a UX fix?
Page with default options
Initialize repository with a README is selected by default. If this value remains unchanged, the user sees this page, with no CLI command instruction:
Page if value is deselected
If the user knows enough to deselect Initialize repository with a README then they'll be presented with the page that has more options. The most helpful information about CLI commands isn't shown to users by default, which doesn't seem good from a UX perspective:
Proposal
Amy to add clarifying information to https://docs.gitlab.com/ee/gitlab-basics/start-using-git.html#add-a-remote - other places might also be necessary - and @pedroms for awareness of potential UX improvements.