Merge pull request #567 from IBM/docs/source-migration

Document to create `iproj.json` before source migration
IBM · Aug 27, 2024 · be0d635 · be0d635
2 parents 5227a04 + ef4f06e
commit be0d635
Showing 1 changed file with 4 additions and 2 deletions.
diff --git a/docs/pages/projectExplorer/migrate-source.md b/docs/pages/projectExplorer/migrate-source.md
@@ -2,11 +2,13 @@
 
 A quick and easy way to get started with local development is to begin with migrating source from QSYS. This source migrating process leverages the `cvtsrcpf` command in `makei` as a source code conversion tool. This command essentially converts all members in a given source physical file to properly encoded, terminated, and named source files in an IFS directory. Following this conversion, the files will be bundled into a tar file which will be downloaded and extracted into the project so that you can begin with local development.
 
-?> To learn more about this source code conversion too, check out the documentation on [cvtsrcpf](https://ibm.github.io/ibmi-bob/#/cli/makei?id=cvtsrcpf).
+?> To learn more about this source code conversion tool, check out the documentation on [cvtsrcpf](https://ibm.github.io/ibmi-bob/#/cli/makei?id=cvtsrcpf).
 
 ## Start the Source Migration
 
-To begin the source migration process, browse for the library containing the source physical files you would like to migrate using the **Object Browser** view. Once you have found the desired library, use the **Migrate Source** action. This can also be done on any library in the **Project Explorer** view.
+To begin the source migration process, first ensure that you have a workspace folder opened with an `iproj.json` file. If you are creating a new project, follow the steps [here](pages/projectExplorer/create-new-project?id=create-new-project) which outline how this file can be created.
+
+Now that your workspace folder is recognized as an IBM i project, browse for the library containing the source physical files you would like to migrate using the **Object Browser** view. Once you have found the desired library, use the **Migrate Source** action. This can also be done on any library in the **Project Explorer** view.
 
 ![Migrate Source](../../assets/ProjectExplorer_37.png)