Edits permissions and roles page.

Author: chloeredhat

docs/modules/ROOT/pages/getting-started/roles_persmissions.adoc

@@ -1,24 +1,60 @@
 = Permissions and roles
 
+== Getting started 
+
+When the administrators at {ProductName} create a workspace for you, you automatically have the role of *Admin*. 
+
+== Types of roles
+
 The following list shows the three roles that are available in a workspace:
 
 * *Contributor*: Ideal for users who actively push to your workspace
 * *Maintainer*: Ideal for users who need to manage the workspace, but who don't need access to sensitive actions like managing security or deleting a workspace
-* *Owner*: Ideal for users who need full access to the workspace, including sensitive actions like managing security or deleting a workspace
+* *Admin*: Ideal for users who need full access to the workspace, including sensitive actions like managing security or deleting a workspace
+
+== Adding or changing users 
 
-== Adding a user
 We currently do not support adding users in the user interface (UI). To add a collaborator, you can send us a Slack message in the https://rhdevnation.slack.com/archives/C04LXT1EU7K[#software-supply-chain-security] channel and we will process your request.
 
 Or, send a message in the chat feature in the {ProductName} application. 
 
+////
+
+To begin adding, editing, or removing users from a workspace, complete the following steps:
+. In the side bar, select *Workspaces*. 
+. Select the tab *Access*. 
+
+=== Adding a user to a workspace
+
+. In *Find by username*, enter the users that you want to grant access to. 
+* Optionally, change *Username* to the search option of your choice. 
+. Select *Grant Access*. 
+. In *Assign role*, select either *Contributor*, *Maintainer*, or *Admin*. 
+* To view the permissions for each role, select *Show list*. 
+. Select *Save*. 
+
+=== Removing a user from a workspace
+. Select the three dots next to the user that you want to remove. 
+. Select *Remove access*.
+. To confirm, select *Remove*. 
+
+=== Editing the access of a user
+. Select the three dots next to the user that you want to edit. 
+. Select *Edit access*. 
+. In *Assign roles*, change the drop-down to the new role that you want. 
+* To view the permissions for each role, select *Show list*. 
+. Select *Save changes*. 
+
+////
+
 == Permissions by role
 
 The following table shows the actions that each type of collaborator can perform: 
 
 .Permissions for each type of collaborator
 
 |===
-|Action |Contributor |Maintainer |Owner
+|Action |Contributor |Maintainer |Admin
 
 |*Workspace:* 
 

styles/RedHat/Abbreviations.yml

@@ -0,0 +1,9 @@
+---
+extends: existence
+level: error
+link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/abbreviations/
+message: "Do not use periods in all-uppercase abbreviations such as '%s'."
+nonword: true
+source: "IBM - Periods with abbreviations, p. 5"
+tokens:
+  - '\b(?:[A-Z]\.){3,5}'

styles/RedHat/CaseSensitiveTerms.yml

@@ -0,0 +1,297 @@
+---
+extends: substitution
+ignorecase: false
+level: error
+link: https://redhat-documentation.github.io/vale-at-red-hat/docs/reference-guide/casesensitiveterms/
+message: Use '%s' rather than '%s'.
+source: "https://redhat-documentation.github.io/supplementary-style-guide/#glossary-terms-conventions"
+action:
+  name: replace
+swap:
+  "(?<!/)var": VAR
+  # Bind: BIND
+  '(?<!\.)yaml|Yaml': YAML
+  '(?<!Business )Resource Planner|(?<!Business Resource )Planner': Business Resource Planner
+  '(?<!JBoss )EAP|(?<!Red Hat )JBoss(?!\sCommunity|\sBroker|\sClients|\sConsole|\sAMQ|\sData\sGrid|\sBRMS|\sBPMS|\sEnterprise\sApplication\sPlatform|\.org|\sInterconnect|\sEAP|\sBPM\sSuite)': JBoss EAP
+  '(?<!Microsoft )Azure': Microsoft Azure
+  '(?<!Microsoft Azure )On-Demand Marketplace': Microsoft Azure On-Demand Marketplace
+  '(?<!Realtime )Decision\sServer': Realtime Decision Server
+  '(?<!Red Hat )Customer Portal': Red Hat Customer Portal
+  '(?<!Red Hat )JBoss Enterprise Application Platform': Red Hat JBoss Enterprise Application Platform
+  '(?<!Red Hat )OpenStack Platform|RHOS|RH-OSP': Red Hat OpenStack Platform
+  '(?<!Red Hat JBoss )BRMS(?! engine)': inference engine
+  '(?<!Red Hat JBoss )BRMS|BRM|(?<!Red Hat )JBoss BRMS': Red Hat JBoss BRMS
+  '[nN]odejs|[nN]ode\.JS|node\.js': Node.js
+  '\s\.Net Core|\s\.Net|\s\.NET\sCore|dotNet': .NET
+  'A-MQ(?!\sBroker|\sClient|\sConsole|\sInterconnect)': AMQ
+  'A-MQ\sBroker': AMQ Broker
+  'A-MQ\sClients': AMQ Clients
+  'A-MQ\sConsole': AMQ Console
+  'A-MQ\sInterconnect': AMQ Interconnect
+  'ack\spacket|ACK(?!\sflag)|ack': ACK flag
+  'ActiveMQ\sArtemis|ActiveMQ(?!\sArtemis)': built-in messaging|JBoss EAP built-in messaging|JBoss EAP messaging
+  'Admin\sPortal|webadmin\sportal|webadmin|Administrator\sPortal|Administration\sportal': Administration Portal
+  'BPMS|(?<!Red Hat )JBoss BPMS|(?<!Red Hat JBoss )BPM(?! Suite)': Red Hat JBoss BPM Suite
+  'BRMS\sengine': inference engine
+  'DM(?![ -]Multipath)|directory manager': Directory Manager
+  'GUI\seditor|Business\sCentral\seditor': guided editor
+  'JBoss Broker|Red Hat Broker|The AMQ Broker': AMQ Broker
+  'JBoss Console|Red Hat Console': AMQ Console
+  'JBoss\.org': JBoss Community
+  'JBoss\sAMQ': AMQ
+  'JBoss\sInterconnect': AMQ Interconnect
+  'Kernel(?!-based Virtual Machine)': kernel
+  'Kie(?!\sServer)': KIE
+  'Kie\sServer': Intelligent Process Server
+  'O\.K\.D|okd|OpenShift Kubernetes Distribution|OpenShift\sOrigin': OKD
+  'OCM|(?<!Red Hat OpenShift )Cluster Manager|(?<!Red Hat )OpenShift Cluster Manager|the OpenShift Cluster Manager': Red Hat OpenShift Cluster Manager
+  'OD': Red Hat OpenShift Dedicated
+  'Red\sHat\sInterconnect': AMQ Interconnect
+  'Red\sHat\sVirtualization\sHypervisor|RHV\sHost|RHV-H': Red Hat Virtualization Host
+  'RHVM|RHV-M|RHV\sManager': Red Hat Virtualization Manager
+  'self-hosted\sengine\svirtual\smachine|engine\sVM': Manager virtual machine
+  Appliance Console: Appliance console
+  Applix|ApplixWare: Applixware
+  asciidoctor|AsciiDoctor: Asciidoctor
+  asciidoc|Asciidoc: AsciiDoc
+  assertj|Assertj: AssertJ
+  auto-link|AutoLink: autolink
+  basic authentication|Basic Authentication|basic auth|Basic auth|Basic Auth: Basic HTTP authentication (first instance)|Basic authentication
+  BC: Business Central
+  Bios: BIOS
+  blue print|BluePrint: blueprint
+  bluestore|Blue Store: BlueStore
+  btrfs: Btrfs
+  Capex|capex|capEx: CapEx
+  Capsule server: Capsule Server
+  CD 1: CD #1
+  CDS|Cds: CDs
+  Ceph Ansible: ceph-ansible
+  Ceph block device|Ceph block devices: Ceph Block Device
+  Ceph filesystem|Ceph file system: Ceph File System
+  Ceph monitor: Ceph Monitor
+  Ceph object gateway|Ceph object gateways: Ceph Object Gateway
+  ceph-osd|Object Storage Device|OSD daemon: OSD
+  cephfs: CephFS
+  CGroup|c group: cgroup
+  cidr|Classless Interdomain Routing|Classless Inter-domain Routing: CIDR
+  classic mode: GNOME Classic
+  CloudForms Management Engine|CFME: Red Hat CloudForms|Red Hat CloudForms Appliance
+  command prompt: shell prompt|Command Prompt (Windows product)
+  Composite Content view|composite content view|Composite View|composite view: Composite Content View
+  configmap: config map
+  configuration map: config map
+  Content view|content view: Content View
+  control key|ctrl: Ctrl
+  crush map|crushmap: CRUSH map
+  csv: CSV
+  CygMon|cygmon|CYGMON: Cygmon
+  Data Grid Administration Console: Data Grid Console
+  Data Grid console: Data Grid Console
+  Denial of Service: denial of service
+  Denial-of-Service: denial-of-service
+  Development Preview|Developer preview|dev preview: Developer Preview
+  devops|Devops|Dev-Ops|Dev Ops: DevOps
+  directory server: Directory Server
+  Disk druid|disk druid|diskdruid: Disk Druid
+  dns: DNS
+  DVD burner|burner: DVD writer
+  DWH|data warehouse|Dataware House: Data Warehouse
+  Etcd|ETCD: etcd
+  Exec Shield: Exec-Shield
+  EXIF|exif: Exif
+  Extranet: extranet
+  facter: Facter
+  Faq|faq|F.A.Q: FAQ
+  fault tolerant: fault-tolerant
+  fault-tolerance: fault tolerance
+  fedora project: Fedora™ Project
+  filestore|File Store: FileStore
+  Firewalld|firewallD|FirewallD: firewalld
+  Firewire|firewire: FireWire
+  FlatHub: Flathub
+  FlatPak: Flatpak
+  fortran: Fortran
+  Fqdn|fqdn: FQDN
+  gbps|GBPS: Gbps
+  gb|Gb: GB
+  GDBTK: Insight
+  gid|Gid: GID
+  Gimp|gimp: GIMP
+  git|GIT: Git
+  Gnome|gnome: GNOME
+  Gnu|gnu: GNU
+  Gpl|gpl: GPL
+  Graalvm|graalVM: GraalVM
+  Greenboot|green boots: greenboot
+  Grub: GRUB
+  GTK|Gtk|gtk: GTK+
+  hot rod|HotRod|hotrod: Hot Rod
+  HP Proliant: HP ProLiant
+  HTTP interface: management console
+  hyperthreading|hyper-threading: Hyper-Threading
+  HyperVisor|Hyperviser: hypervisor
+  IA64|ia64: Itanium
+  IBM z Systems: IBM Z
+  Ignite|Fuse Ignite: Fuse Online|Red Hat Fuse Online|Syndesis
+  ignition config: Ignition config
+  Image Builder: image builder
+  INSTALL_DIR|installDir: FUSE_HOME
+  Iops|IOPs: IOPS
+  Ip: IP
+  IPSec: IPsec
+  ipv4|IPV4|Ipv4: IPv4
+  ipv6|IPV6|Ipv6: IPv6
+  iSeries: ISeries
+  iso: ISO
+  Itanium2: Itanium 2
+  jar file: JAR file
+  JBoss Clients: AMQ Clients
+  JBoss Data Grid: Data Grid
+  jetbrains|Jetbrains: JetBrains
+  Junit|junit: JUnit
+  Jvm|jvm: JVM
+  kbase|knowledge base: KIE base
+  kernel-based virtual machine: Kernel-based Virtual Machine
+  kernelspace: kernel space
+  key store: keystore
+  kickstart: Kickstart
+  kie API|Kie API|knowledge API: KIE API
+  kjar|kJAR: KJAR
+  knowledgebase: Knowledgebase
+  ksession|knowledge session: KIE session
+  Kubelet: kubelet
+  kubernetes|k8s: Kubernetes
+  kvm: KVM
+  Lan|lan: LAN
+  Librados|LIBRADOS: librados
+  Librbd|LIBRBD: librbd
+  Lightweight Directory Access Protocol over Secure Socket Layer: LDAPS
+  LINUX|linux: Linux
+  live-backup group: master-slave group
+  Lun|lun: LUN
+  master CA: IdM CA renewal server
+  master server: IdM server and replicas
+  Microprofile|micro-profile: MicroProfile
+  Microsoft Azure Portal: Microsoft Azure portal
+  Microsoft Windows Server: Windows Server
+  MoM|Mom|mom: MOM
+  Mongo\sDB|mongoDB|Mongodb|Mongo-db: MongoDB
+  MS(?!-DOS?)|MSFT|MicroSoft: Microsoft
+  MS-dos|Ms-Dos|ms-dos|MSDOS|msdos: MS-DOS
+  MTLS|m-TLS: mTLS
+  mutual tls|Mutual tls|Mutual TLS: mutual TLS
+  MYSQL|mySQL: MySQL
+  native interface: management CLI
+  network interface card: network interface controller (NIC)
+  objectclass: objectClass
+  Objective-C: Objective C
+  OCP: Red Hat OpenShift Container Platform
+  ODF: Red Hat OpenShift Data Foundation
+  Open InfiniBand|Infiniband: InfiniBand
+  openid connect|Openid Connect: OpenID Connect
+  Openshift online|OO: Red Hat OpenShift Online
+  Operating Environment: operating environment
+  Operator Hub|Operator hub|Operatorhub|operatorhub: OperatorHub
+  Opex|Opex|OPEX|opEx: OpEx
+  Organization administrator|Org Admin|org admin: Organization Administrator
+  OS|Operating System: operating system
+  Overcloud: overcloud
+  Podman desktop: Podman Desktop
+  podman: Podman
+  popup|Pop-up: pop-up
+  Posix|posix: POSIX
+  Postscript: PostScript
+  Powershell|powershell: PowerShell
+  PPC|P-PC|PPC64: PowerPC
+  Ppp|ppp: PPP
+  prom|Prom: PROM
+  proof key for code exchange: Proof Key for Code Exchange
+  proof of concepts: proofs of concept
+  Properties editor: Properties View
+  pSeries: IBM eServer System p
+  puppet forge: Puppet Forge
+  puppet: Puppet
+  q & a|q&a|Q & A|Q&A: Q and A
+  qcow2|Qcow2: QCOW2
+  Qdmanage|QDMANAGE: qdmanage
+  Qdstat|QDSTAT: qdstat
+  Qeth|QETH: qeth
+  RAMdisk|ramdisk|RAM-disk: RAM disk
+  Ram|ram: RAM
+  RAW: raw
+  Red Hat JBoss Data Grid|JDG: Red Hat Data Grid
+  Red Hat JBoss EAP: Red Hat JBoss Enterprise Application Platform
+  Red Hat Network Satellite server: Red Hat Network Satellite Server
+  Red Hat Proxy: Red Hat Network Proxy Server
+  Red Hat Satellite Capsule server: Red Hat Satellite Capsule Server
+  Red Hat Satellite server: Red Hat Satellite Server
+  Red Hat satellite: Red Hat Satellite
+  Redboot|Red Boot: RedBoot
+  redis: Redis
+  RESTEASY|resteasy|Resteasy: RESTEasy
+  RHDS: Red Hat Directory Server
+  RHEL host|RHEL-H: Red Hat Enterprise Linux host
+  RHV: Red Hat Virtualization
+  Rom|rom: ROM
+  rpm: RPM
+  s-record|S-Record|s-Record|SREC: S-record
+  samba|SAMBA: Samba
+  Satellite server: Satellite Server
+  SE-Linux|S-E Linux|SE Linux|selinux: SELinux
+  Shadow Man|ShadowMan: Shadowman
+  Shadow passwords: shadow passwords
+  Shadow utilities: shadow utilities
+  Smallrye: SmallRye
+  smart NIC|Smart-NIC: SmartNIC
+  Smart State|smart state|Smart state|Smartstate|Analysis: SmartState analysis
+  socks: SOCKS
+  software collection|Software collection: Software Collection
+  Source Navigator: Source-Navigator^TM^
+  Spec: spec
+  Spice|spice: SPICE
+  Spring boot: Spring Boot
+  SR IOV: SR-IOV
+  Ssh|ssh: SSH
+  SSL handshake: TLS handshake
+  SSL(?!/TLS): SSL/TLS
+  standard Manager|standard environment: standalone Manager
+  Staroffice|Star Office: StarOffice
+  StartTLS|startTLS: STARTTLS
+  StartX: startx
+  STI|source to image: Source-to-Image (S2I)
+  SU: su
+  Subscription manifest: Subscription Manifest
+  Sys V|System V: SysV
+  system D|system D|SystemD|system d: systemd
+  Technology preview|technology preview: Technology Preview
+  The Operator Lifecycle Manager: Operator Lifecycle Manager
+  Tolapai|Intel Tolapai: Intel(R) EP80579 Integrated Processor
+  ttl: TTL
+  uid: UID
+  ULTRASPARC|UltraSparc: UltraSPARC
+  Unix|unix|UNIX-like: UNIX
+  url: URL
+  urn: URN
+  VCPU|vcpu: vCPU
+  VI: vi
+  VIM|vim: Vim
+  Virtual Desktop Server Management: VDSM
+  virtual-console|Virtual Console: virtual console
+  vlan|vLAN: VLAN
+  VM portal|vm portal|Virtual Machine Portal|User Portal: VM Portal
+  vnic|VNIC|Virtual Network Interface Card: vNIC
+  vnuma|VNUMA: vNUMA node
+  vpn: VPN
+  VS Code|VSCode|VisualStudioCode|VisualStudio Code: Visual Studio Code
+  VT-i|VT: Intel Virtualization Technology
+  wan: WAN
+  wca: WCA
+  web-UI|webUI: web UI
+  Webauthn|webAuthn|WebAuthN: WebAuthn
+  websocket|Websocket: WebSocket
+  Window-Maker|WindowMaker: Window Maker
+  Xemacs: XEmacs
+  xplat-cli|x-plat-cli|xplat cli|x-plat cli|X-PLAT CLI|X-PLAT-CLI|XPLAT-CLI|XPLAT CLI: Microsoft Azure Cross-Platform Command-Line Interface
+  Xp|xp: XP
+  Xterm: xterm

styles/RedHat/Conjunctions.yml

@@ -0,0 +1,14 @@
+---
+extends: existence
+level: suggestion
+link: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/reference-guide/conjunctions/
+message: "Do not overuse beginning sentences with '%s'."
+scope: paragraph
+source: https://github.com/redhat-documentation/vale-at-red-hat/tree/main/.vale/styles/RedHat/Conjunctions.yml
+action:
+  name: remove
+tokens:
+  - ^And
+  - ^But
+  - ^Or
+  - ^So