DOC-2583: Farzad/Lewis structural improvements

Farzad Hayatbakhsh · Farzad Hayatbakhsh · commit c449ddbfad1b · 2024-12-09T15:15:13.000+10:00
diff --git a/modules/ROOT/pages/export-to-pdf-with-jwt-authentication-with-php.adoc b/modules/ROOT/pages/export-to-pdf-with-jwt-authentication-with-php.adoc
@@ -9,17 +9,17 @@ include::partial$auth/document-converters/php/intro-and-prerequisites.adoc[]
 
 include::partial$auth/document-converters/php/initial-project-setup.adoc[]
 
-. Inside the `public` folder where you created the `index.html` file add the HTML setup code (refer to the *Setting up {productname} HTML* section).
-
 == Setup
 
-include::partial$auth/document-converters/jwt-setup-document-converters.adoc[leveloffset=+1]
+=== Generate a Public/Private Key Pair
 
-. In the root directory, copy and paste the server setup code into the `jwt.php` file.
+include::partial$auth/document-converters/jwt-setup-document-converters.adoc[leveloffset=+2]
 
 include::partial$auth/document-converters/php/server-setup-php.adoc[]
 
-==== Web Page Setup (index.html)
+=== Web Page Setup (index.html)
+
+Inside the `public` folder where you created the `index.html` file add the HTML setup code:
 
 [source,html]
 ----
diff --git a/modules/ROOT/pages/export-to-word-with-jwt-authentication-with-php.adoc b/modules/ROOT/pages/export-to-word-with-jwt-authentication-with-php.adoc
@@ -9,19 +9,16 @@ include::partial$auth/document-converters/php/intro-and-prerequisites.adoc[]
 
 include::partial$auth/document-converters/php/initial-project-setup.adoc[]
 
-
-. Inside the `public` folder where you created the `index.html` file add the HTML setup code (refer to the *Setting up {productname} HTML* section).
-
 == Setup
 
-include::partial$auth/document-converters/jwt-setup-document-converters.adoc[leveloffset=+1]
-
-. In the root directory, copy and paste the server setup code into the `jwt.php` file.
+include::partial$auth/document-converters/jwt-setup-document-converters.adoc[leveloffset=+2]
 
 include::partial$auth/document-converters/php/server-setup-php.adoc[]
 
 ==== Web Page Setup (index.html)
 
+Inside the `public` folder where you created the `index.html` file add the HTML setup code:
+
 [source,html]
 ----
 <!DOCTYPE html>
diff --git a/modules/ROOT/pages/import-word-with-jwt-authentication-with-php.adoc b/modules/ROOT/pages/import-word-with-jwt-authentication-with-php.adoc
@@ -9,18 +9,16 @@ include::partial$auth/document-converters/php/intro-and-prerequisites.adoc[]
 
 include::partial$auth/document-converters/php/initial-project-setup.adoc[]
 
-. Inside the `public` folder where you created the `index.html` file add the HTML setup code (refer to the *Setting up {productname} HTML* section).
-
 == Setup
 
-include::partial$auth/document-converters/jwt-setup-document-converters.adoc[leveloffset=+1]
-
-. In the root directory, copy and paste the server setup code into the `jwt.php` file.
+include::partial$auth/document-converters/jwt-setup-document-converters.adoc[leveloffset=+2]
 
 include::partial$auth/document-converters/php/server-setup-php.adoc[]
 
 ==== Web Page Setup (index.html)
 
+Inside the `public` folder where you created the `index.html` file add the HTML setup code:
+
 [source,html]
 ----
 <!DOCTYPE html>
diff --git a/modules/ROOT/partials/auth/document-converters/php/initial-project-setup.adoc b/modules/ROOT/partials/auth/document-converters/php/initial-project-setup.adoc
@@ -1,19 +1,22 @@
-== Update PHP php.ini Files
+== Update PHP Configuration File
 
-Update files inside the downloaded php package:
+Use the following command to locate the PHP configuration file:
 
-* php.ini
-* php.ini-development
-* php.ini-production
+[source,bash]
+----
+php --ini
+----
 
-Ensure the following lines are uncommented:
+Open the configuration file in a text editor and ensure the following settings are enabled:
 
-[source, bash]
+[source,ini]
 ----
 extension=openssl 
-extension_dir={Depends on your development environment} 
+extension_dir='ext'
 ----
 
+The path to the extension directory may vary depending on your system.
+
 == Quick Start Guide
 
 === Project Setup
@@ -42,7 +45,7 @@ Your project should look like this:
 ----
 /tinymce-app
   index.html  (TinyMCE webpage)
-  jwt.php       (Server code)
+  jwt.php     (Server code)
   composer.json
   composer.lock
   vendor     
diff --git a/modules/ROOT/partials/auth/document-converters/php/intro-and-prerequisites.adoc b/modules/ROOT/partials/auth/document-converters/php/intro-and-prerequisites.adoc
@@ -21,9 +21,9 @@ This guide is designed for developers new to JWT authentication and {productname
 
 Before starting, ensure you have:
 
-* PHP installed on your computer
-* OpenSSL installed on your computer
-* Composer installed on your computer
+* PHP installed on your computer (to check, run `php -v` in your terminal)
+* OpenSSL installed on your computer (to check, run `openssl version` in your terminal)
+* Composer installed on your computer  (to check, run `composer -v` in your terminal)
 * A {productname} API key (get one from link:https://www.tiny.cloud/signup[TinyMCE's website])
 * Basic familiarity with the command line
 
diff --git a/modules/ROOT/partials/auth/document-converters/php/server-setup-php.adoc b/modules/ROOT/partials/auth/document-converters/php/server-setup-php.adoc
@@ -1,4 +1,6 @@
-==== Server Setup (jwt.php)
+=== Server Setup (jwt.php)
+
+In the root directory, copy and paste the server setup code into the `jwt.php` file:
 
 [source,php]
 ----
