Can't add a theme from private repo (because the interface changed but the instructioons didn't)

AI-generated summary

Users are discussing issues with installing a theme from a private Git repository due to outdated documentation and interface changes. pfaffman reports missing UI elements like the ‘in a private repo’ checkbox, despite trying multiple sites and safe mode. Moin clarifies that users must use the SSH clone link, not HTTPS, referencing an older guide. pfaffman agrees but suggests the instruction should be more obvious. Moin notes Step 6 mentions a checkbox that no longer exists. pfaffman edits the guide to improve clarity, acknowledging the need for updated screenshots. Moin expresses surprise that pfaffman, a TL4, could edit official docs, citing Hugh Lashbrooke who explains only team members can edit docs for consistency. pfaffman proposes a UX improvement: if users click ‘Advanced’ without pasting an SSH link, the interface should gently prompt them to use SSH. pfaffman jokes about being mistaken for a team member, and Moin clarifies he knew pfaffman was TL4 but not part of the team. pfaffman humorously resolves to stop editing docs as if he were on the team. Heliosurge notes that Hugh has taken over from Jammy. Finally, Lilly confirms the topic has been updated with revised instructions and new screenshots.

Continuing the discussion from Installing a theme from a private Git repository:

Has there been a regression? I don’t see “in a private repo” checkbox. I tried several sites and even safe-mode.:

Since you aren’t the first one. I think the guide needs to be improved.

Oh.

Well, shouldn’t it be more obvious?

Oh. I guess not.

Maybe the problem is that step 6 mentions a checkbox which isn’t shown.

I made some edits that I think help.

There need to be new images, but this is better than the old instructions that don’t match the current interface.

Jammy is gone and I’ve forgotten who replaced them.

I am surprised you were able to do that

But what I think we really need is if you click the advanced button, have a thing that says “use a ssh link for private directories, OK?”

showPublicKey gets set if a ssh link is pasted in, so what might be good is if they click “advanced” and haven’t pasted a ssh link, to tell me that I are an idiot. (But in a nice way.)

https://github.com/discourse/discourse/blob/main/app/assets/javascripts/admin/addon/components/modal/install-theme.hbs#L119-L142

Yeah. People keep being surprised that I’m TL4. Last week I replied to something that no one is supposed to reply to. I think I managed not to do that this time. :slight_smile:

I know you are TL4. But I didn’t know you are part of the Discourse team :slight_smile:

Yeah. I should probably stop editing those things as if I were. :person_shrugging:

@hugh has stepped into the role in the meantime.

Thanks Jay. I’ve updated that topic with revised text instructions and new screenshots.