In a support discussion titled ‘Unclear double question in setup wizard,’ icaria36 points out that Discourse’s setup wizard asks two nearly identical questions — ‘Describe your community in one short sentence’ and ‘Describe your community in few words’ — without clarifying where each will be used, leading to potential confusion for new admins. IAmGav notes that examples are shown in some installations, and settings can be edited later, but icaria36 counters that first-time users may not know this, and the examples don’t clearly differentiate the purposes. osioke agrees the ambiguity was initially confusing but suggests adding context about where each description appears. icaria36 proposes clearer, more specific wording that preserves translations. IAmGav confirms it’s an easy change pending team approval. osioke reports that a PR has been submitted with improved strings: ‘Describe your community in one sentence. (Used in search results and social media)’ and ‘Describe your community in few words, for the homepage title.’ icaria36 praises the quick, thoughtful resolution. IAmGav adds that DigitalOcean’s outdated marketplace image still needs updating to reflect these changes.
When setting up Discourse for the first time, users go through a wizard. This wizard contains two questions that are virtually identical:
Describe your community in one short sentence
… Describe your community in few words
There is no context offered, like where exactly each string will appear. I wonder how many admins just add the same sentence twice.
The wizard itself is very minimalist and polished. Kudos! This kind of double question is the only confusing point. Not a dealbreaker and probably this is something that most of us forget because we just want to have our new Discourse up & running. Still, if there is a perfectionist in charge of this wizard, I think there is room for improvement here. Clearer sentences explaining what is each sentence for might suffice.
In the start, I also found this confusing, but as I learned where each description was used, it made it clearer. Would adding some context as to where the description is used be any helpful? cc: @community
The strings already exist, and they could just replace the ones in the wizard (for an easy solution that would keep translations intact):
-- Describe your community in one short sentence
++ Describe this site in one sentence, as used in the meta description tag.
-- Describe your community in few words
++ Short description, as used in the title tag on homepage.
-- Describe your community in one short sentence
++ Describe your community in one sentence. (Used in search results and social media)
-- Describe your community in few words
++ Describe your community in few words, for the homepage title.
