Documentation updates

Author: martindsouza

README.md

@@ -6,14 +6,15 @@
 - [Build Image](#build-image)
 - [Run Container](#run-container)
 - [Container Commands](#container-commands)
-- [Connecting](#connecting)
+- [Other](#other)
   - [SQL](#sql)
+  - [APEX Install](#apex-install)
   - [SSH into Container](#ssh-into-container)
   - [OEM](#oem)
   - [Creating a PDB](#creating-a-pdb)
-- [Other](#other)
+  - [`emp` and `dept` tables](#emp-and-dept-tables)
+  - [Preserving `/opt/oracle/oradata` for Multiple Copies](#preserving-optoracleoradata-for-multiple-copies)
 - [Docker Developers](#docker-developers)
-- [Preserving `/opt/oracle/oradata` for Multiple Copies](#preserving-optoracleoradata-for-multiple-copies)
 
 <!-- /TOC -->
 
@@ -83,7 +84,7 @@ docker start oracle-xe
 docker stop -t 200 oracle-xe
 ```
 
-## Connecting
+## Other
 
 ### SQL
 
@@ -96,9 +97,12 @@ sqlcl sys/Oracle18@localhost:32118/XE as sysdba
 
 -- Connect to default PDB
 sqlcl sys/Oracle18@localhost:32118/XEPDB1 as sysdba
-
 ```
 
+### APEX Install
+
+An example to install APEX into the default container is available [here](docs/apex-install.md).
+
 ### SSH into Container
 
 In some cases you may need to login to the server to modify or test something on the file system.
@@ -154,18 +158,14 @@ To connect to the new PDB :
 sqlcl sys/Oracle18@localhost:32118/XEPDB2 as sysdba
 ```
 
-## Other
+### `emp` and `dept` tables
 
 Install `emp` and `dept` sample tables:</br>
 
 `@https://raw.githubusercontent.com/OraOpenSource/OXAR/master/oracle/emp_dept.sql`
 
-## Docker Developers
-
-If you're interested in helping maintain this project check out [docker-dev](docs/docker-dev.md) document.
-
 
-## Preserving `/opt/oracle/oradata` for Multiple Copies
+### Preserving `/opt/oracle/oradata` for Multiple Copies
 
 Each time you start a container that does has an empty `/opt/oracle/oradata` Oracle XE is configured and the data files are created for the CDB and one PDB (`XEPDB1`). If you plan to launch multiple separate containers for Oracle XE, it is unnecessary to spend this time waiting for the same base files to be created. The solution is fairly simple. It involves creating a sample/seed container, extracting the data files, then copying those data files each time you launch a new container for a new instance of Oracle XE. The following commands demonstrates how to do this:
 
@@ -217,4 +217,8 @@ docker ps
 CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS                            PORTS                               NAMES
 69b52a37a1c6        oracle-xe:18c       "/bin/sh -c 'exec ${…"   8 minutes ago       Up 8 minutes (health: starting)   5500/tcp, 0.0.0.0:32182->1521/tcp   oracle-xe02
 14eea4c699d3        oracle-xe:18c       "/bin/sh -c 'exec ${…"   9 minutes ago       Up 9 minutes (health: starting)   5500/tcp, 0.0.0.0:32181->1521/tcp   oracle-xe01
-```
+```
+
+## Docker Developers
+
+If you're interested in helping maintain this project check out [docker-dev](docs/docker-dev.md) document.

docs/apex-install.md

@@ -1,8 +1,17 @@
 # How to Install APEX in PDB
 
+<!-- TOC -->
+
+- [How to Install APEX in PDB](#how-to-install-apex-in-pdb)
+  - [Assumptions](#assumptions)
+  - [APEX Installation](#apex-installation)
+  - [ORDS](#ords)
+
+<!-- /TOC -->
+
 This documentation will walk through how to create a new PDB and install it. Please ensure that you have [downloaded](https://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html) the latest copy of APEX.
 
-Assumptions:
+## Assumptions
 
 Item | Description
 --- | ---
@@ -11,6 +20,9 @@ APEX Version | `18.2`. The zip file is located in:
 PDB | `XEPDB1` (_default PDB that comes with XE_)
 APEX Admin Password: `Oradoc_db1`
 
+
+## APEX Installation
+
 ```bash
 # Copy APEX zip file to container
 docker cp ~/docker/files/apex/apex_18.2_en.zip oracle-xe:/tmp
@@ -34,4 +46,8 @@ cd /tmp
 rm -rf apex*
 
 exit
-```
+```
+
+## ORDS
+
+[docker-ords](https://github.com/martindsouza/docker-ords) contains instructions on how to setup a docker instance of ORDS