From cd548c7c76ac7f9b3ae7f13a13cc20ae9962ad81 Mon Sep 17 00:00:00 2001
From: Aramis Sennyey <34432188+sennyeya@users.noreply.github.com>
Date: Wed, 31 Jan 2024 12:31:50 -0500
Subject: [PATCH] Apply suggestions from code review

Co-authored-by: Dave Welsch <116022979+dwelsch-esi@users.noreply.github.com>
Signed-off-by: Aramis Sennyey <34432188+sennyeya@users.noreply.github.com>
---
 docs/references/glossary.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/references/glossary.md b/docs/references/glossary.md
index 45c2bbcd35..9d525d2430 100644
--- a/docs/references/glossary.md
+++ b/docs/references/glossary.md
@@ -99,9 +99,9 @@ An executable or package file with all of the necessary information required to
 
 ## Developer
 
-Someone who writes code and develops software.
+1. Someone who writes code and develops software.
 
-A [user role](#user-role) defined as someone who uses a Backstage [app](#app). Might or might not actually be a software developer.
+2. A [user role](#user-role) defined as someone who uses a Backstage [app](#app). Might or might not actually be a software developer.
 
 ## Developer Portal
 
@@ -251,11 +251,11 @@ An [entity](#entity) that represents a piece of physical or virtual infrastructu
 
 ## Resource (permission plugin)
 
-Not to be confused with [Software Catalog resources](#resource-catalog-plugin). Permission resources represent the objects that users interact with and that can be permissioned.
+A representation of an object that a user interacts with and that can be permissioned. Not to be confused with [Software Catalog resources](#resource-catalog-plugin). 
 
 ## Rule (permission plugin)
 
-Rules are predicate-based controls that tap into a [resource](#resource-permission-plugin)'s data.
+A predicate-based control that taps into a [resource](#resource-permission-plugin)'s data.
 
 ## Role