HelpScout suggestions

[AquiGorka]

The following suggestions have been applied (there is a max 5 items limit on suggestions):

• Home
  • Home
  • Troubleshoot tips
  • About Aragon apps
  • Anatomy of an Aragon organization
  • About Aragon
• Token Manager
  • Token Manager
  • About Aragon
• Voting
  • Voting
  • About Aragon
• Finance
  • Finance
  • About Aragon
• Permissions
  • Permissions
  • About Aragon
• App Center
  • App Center
  • About Aragon
• Settings
  • Settings
  • About Aragon
• Onboarding
  • Prerequisites
  • About templates
  • Create a new Democracy organization
  • Create a Multisig organization
  • About Aragon

@luisivan and @john-light let me know if this is fine or if this needs to be modified.

For the time being these changes make it necessary to deploy in case we want to update the suggestions mapped to a section. This works if we want to quickly publish this out there but for the long run we need another solution that'll make it easy to update suggestions. Pinging @bpierre and @sohkai for ideas here.

[sohkai]

Looks good, a couple small comments and a slightly annoying / confusing thing when you opt-in.

[dizzypaty]

Hey @AquiGorka, I was reviewing these changes and I have a quick question – technically speaking, could we remove the hyperlink styling from the suggested content titles? Or perhaps we could actually open a new tab with the wiki on the anchored section. (We should not redirect users to the wiki from the same page though).

At the moment, the titles and images behave as links but nothing happens on click.

[luisivan]

I think we can remove those links, but @john-light is the person responsible since that's the content itself

[bpierre]

👍

[bpierre]

For the time being these changes make it necessary to deploy in case we want to update the suggestions mapped to a section. This works if we want to quickly publish this out there but for the long run we need another solution that'll make it easy to update suggestions. Pinging @bpierre and @sohkai for ideas here.

Maybe we could pass an HTTP (since HelpScout relies on HTTP already) URL as an environment variable, where a JSON equivalent of suggestions.js could be fetched from?

[AquiGorka]

Thought of using the raw file from this same repo for that purpose, too centralized no?

[bpierre]

Thought of using the raw file from this same repo for that purpose, too centralized no?

Ah yes we could do that! Using HelpScout is centralized already, and users have to opt-in, so I don’t think it would be a big issue to also load this from GitHub.

[john-light]

I think we can remove those links, but @john-light is the person responsible since that's the content itself

The links have been intentionally left in place on HelpScout so that specific sub-sections of the docs can be linked into.