# أضف روابط إلى تعليمات meta.discourse.org داخل لوحة الإدارة

**URL:** https://meta.discourse.org/t/add-links-to-meta-discourse-org-instructions-inside-admin/84375
**Category:** Feature
**Created:** [2 أبريل 2018، 12:07م UTC](https://meta.discourse.org/t/add-links-to-meta-discourse-org-instructions-inside-admin/84375 "2018-04-02T12:07:16Z")
**Posts on this page:** 9
**Page:** 1

<div class="post-metadata">

### Author: ![JohnONolan](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/johnonolan/32/93161_2.png) [@JohnONolan](https://meta.discourse.org/u/JohnONolan)
#### Post date: [2 أبريل 2018، 12:07م UTC](https://meta.discourse.org/t/add-links-to-meta-discourse-org-instructions-inside-admin/84375/1 "2018-04-02T12:07:16Z")

</div>

Hey team! Recently set up a discourse install and noticed one potential area for an easy enhancement.

When you go through Discourse settings, there are a whole bunch of fields for doing things, and none of them have descriptions (or, sometimes, names that you can even figure out). This is a little intimidating.

What I found myself doing was

1. Explore Discourse settings
2. Notice google\_oauth field to enable login with google
3. Grumble at lack of instructions, start searching google for howto get an OAuth2 api key or whatever
4. Grumble some more when that didnt work
5. Eventually discover meta.discourse topic with perfect instructions (including the need to manually enable a totally unrelated google+ API in a totally different area of google’s settings, WTF)

After that, I just searched meta.discourse every single time I was going to set something up and found really fantastic docs on how to do all of it.

So anyway here’s my suggestion: Add a `?` icon/link beside settings fields labels which have respective topics on [meta.discourse.org](http://meta.discourse.org) 🙂 would make initial setup a lot more pleasurable!

---

<div class="post-metadata">

### Author: ![PabloC](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pabloc/32/49633_2.png) [@PabloC](https://meta.discourse.org/u/PabloC)
#### Post date: [2 أبريل 2018، 12:32م UTC](https://meta.discourse.org/t/add-links-to-meta-discourse-org-instructions-inside-admin/84375/2 "2018-04-02T12:32:21Z")

</div>

Same experience here while trying to activate oAuth2 with Google.

+1 for this suggestion.

---

<div class="post-metadata">

### Author: ![fefrei](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/fefrei/32/119538_2.png) [@fefrei](https://meta.discourse.org/u/fefrei)
#### Post date: [2 أبريل 2018، 4:40م UTC](https://meta.discourse.org/t/add-links-to-meta-discourse-org-instructions-inside-admin/84375/3 "2018-04-02T16:40:12Z")

</div>

I really like this idea. 👍  
It might even be more feasible then it appears at first sight: We don’t need a topic for every single setting. Instead, for example, just linking all SSO-related settings to [here](https://meta.discourse.org/t/official-single-sign-on-for-discourse-sso/13045) would already be hugely helpful!

---

<div class="post-metadata">

### Author: ![jomaxro](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jomaxro/32/126216_2.png) [@jomaxro](https://meta.discourse.org/u/jomaxro)
#### Post date: [2 أبريل 2018، 5:12م UTC](https://meta.discourse.org/t/add-links-to-meta-discourse-org-instructions-inside-admin/84375/4 "2018-04-02T17:12:32Z")

</div>

> [@JohnONolan](#):
>
> When you go through Discourse settings, there are a whole bunch of fields for doing things, and none of them have descriptions (or, sometimes, names that you can even figure out). This is a little intimidating.

It’s been on my list to do a full review of site settings and their descriptions. Given the number of settings we have that will take a long time.

However, when I have specific, easily actionable feedback like this I can fix it much more quickly. I don’t see adding a `?` to site settings - that would require some engineering work - but adding links to descriptions is easy enough.

---

<div class="post-metadata">

### Author: ![pfaffman](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pfaffman/32/120154_2.png) [@pfaffman](https://meta.discourse.org/u/pfaffman)
#### Post date: [2 أبريل 2018، 10:35م UTC](https://meta.discourse.org/t/add-links-to-meta-discourse-org-instructions-inside-admin/84375/5 "2018-04-02T22:35:01Z")

</div>

This is probably a good idea for all of the social logins.

---

<div class="post-metadata">

### Author: ![sam](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/sam/32/102149_2.png) [@sam](https://meta.discourse.org/u/sam)
#### Post date: [3 أبريل 2018، 12:33ص UTC](https://meta.discourse.org/t/add-links-to-meta-discourse-org-instructions-inside-admin/84375/6 "2018-04-03T00:33:36Z")

</div>

One possible dev related change we may need is to support hyperlinks in field descriptions. While you perform the review we have to also confirm or build support `do <a href='abc'>something awesome</a>` as a site setting description.

---

<div class="post-metadata">

### Author: ![jomaxro](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jomaxro/32/126216_2.png) [@jomaxro](https://meta.discourse.org/u/jomaxro)
#### Post date: [3 أبريل 2018، 12:44ص UTC](https://meta.discourse.org/t/add-links-to-meta-discourse-org-instructions-inside-admin/84375/7 "2018-04-03T00:44:59Z")

</div>

_Pretty sure_ we support that already - I believe I updated something inside a `<a href=` block before. Will confirm.

Edit: Yep, we support it already. See the `s3 use iam profile` site setting:

> <https://github.com/discourse/discourse/blob/main/config/locales/server.en.yml#L1271>

---

<div class="post-metadata">

### Author: ![jomaxro](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jomaxro/32/126216_2.png) [@jomaxro](https://meta.discourse.org/u/jomaxro)
#### Post date: [10 أكتوبر 2018، 12:50م UTC](https://meta.discourse.org/t/add-links-to-meta-discourse-org-instructions-inside-admin/84375/8 "2018-10-10T12:50:41Z")

</div>

This is now complete. Links to social login configuration instructions are now included in site settings.  
[https://github.com/discourse/discourse/commit/18e99ddfa9368b61074d96fe2d44d279664492ec](https://github.com/discourse/discourse/commit/18e99ddfa9368b61074d96fe2d44d279664492ec)

Also ensured that all other URLs in site settings display as such, instead of as plain text.

> <https://github.com/discourse/discourse/commit/cd2b8d40f1f7fe618a317f9b6111cf42734d208a>

---

<div class="post-metadata">

### Author: ![jomaxro](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jomaxro/32/126216_2.png) [@jomaxro](https://meta.discourse.org/u/jomaxro)
#### Post date: [15 أكتوبر 2018، 10:00م UTC](https://meta.discourse.org/t/add-links-to-meta-discourse-org-instructions-inside-admin/84375/9 "2018-10-15T22:00:00Z")

</div>

This topic was automatically closed after 5 days. New replies are no longer allowed.
