Merge pull request #23 from IBM/workshop-transformer-doc

workshop transformer docs

Author: eric-simpson

docs/workshop/04/observer_b.png

@@ -1,16 +1,16 @@
-## Arcad Observer in Merlin
 
 <!-- panels:start -->
 
 <!-- div:left-panel -->
 
-### Explore the Xrefs
+## Explore the Xrefs
 
-Click on the Explorer view icon, then do a right-click on a source member and select the Open in ARCAD-Observer option to open a new Xref panel: each tab of the panel shows different kinds of Xref information:
+Click on the Explorer view icon, then do a right-click on a source member and select the `Open in ARCAD-Observer` option to open a new Xref panel. Each tab of the panel shows different kinds of Xref information:
 
 <!-- div:right-panel -->
 
 ![](04/observer_a.png)
+![](04/observer_b.png)
 
 <!-- panels:end -->
 

docs/workshop/04_observer.md

@@ -1,11 +1,14 @@
-## Compilation in a sandbox.
+## Compilation in a sandbox
 
 During a development, it can be interesting to compile a source member to check that the compilation works and to be able to do some unit tests.
 
-1. To do that, when a source member is edited, press F1 and select IBM i Developer: Compile, or do a right click in the edited source member and select the compilation option, or do a right click on the source member in the explorer view and select the compilation option.
+1. To do that, when a source member is edited, press F1 and select `IBM i Developer: Compile`, or do a right click in the edited source member and select the compilation option, or do a right click on the source member in the explorer view and select the compilation option.
 2. The compiling job starts.
 3. It is possible to follow the process in the IBM i Build Output.
 4. This job creates a new version, a sandbox version linked to the feature version only for the developer.
+5. Compilation errors and warnings appear in Problems view.  Spool files can be viewed in .logs folder.
+
+To build a project, use `IBM i Developer: Build Project` function
 
 ---
 

docs/workshop/05_build.md

@@ -0,0 +1,19 @@
+
+<!-- panels:start -->
+
+<!-- div:left-panel -->
+
+## Convert to fully free RPGLE
+
+* Edit a RPGLE or SQLRPGLE file.  
+* Right-click in the editor and select the `IBM i Developer: Convert to Fully-free RPG with ARCAD` option. 
+* When completed, the editor is refreshed and the component is automatically recompiled.
+
+<!-- div:right-panel -->
+
+![](07/transformer_a.png)
+![](07/transformer_b.png)
+
+<!-- panels:end -->
+
+---

docs/workshop/07/transformer_a.png

@@ -6,5 +6,6 @@
    - [Usage](workshop/03_ide)
    - [Observer](workshop/04_observer)
    - [Build](workshop/05_build)
+   - [Transformer](workshop/07_transformer)   
 - CI/CD
    - [Usage](workshop/06_cicd)