Move Modules related notes from internals.md into src/Modules/README.md

docs/building/internals.md

@@ -32,14 +32,3 @@ it should be listed as a dependency for FullCLR $Top folder (src\Microsoft.Power
 
 * If assembly is part of CoreCLR build,
 it should be listed as a dependency for CoreCLR $Top folder (src\powershell)
-
-
-Modules
-----------
-
-There are 3 modules directories with the same purpose: they have **content** files (i.e. `*.psm1`, `*.psd1`)
-which would be binplaced by `dotnet`
-
-- `src\Modules` shared between all flavours
-- `src\Microsoft.PowerShell.ConsoleHost\Modules` FullCLR (Windows)
-- `src\powershell\Modules` CoreCLR (all platforms)

src/Modules/README.md

@@ -0,0 +1,25 @@
+Modules
+==========
+
+There are 3 directories with **content** files.
+Content files includes: 
+
+- ps1xml
+- psm1
+- psd1
+- ps1
+
+These files are copyied as-is by `dotnet`
+
+- **Shared** is shared between all flavours
+- **Full** for FullCLR (Windows)
+- **Core** for CoreCLR (all platforms)
+
+Notes
+-----------
+
+* We have files with the same names in "Full" and "Core" folders.
+That means that the contents of these two files are different. 
+I.e. if it's .psd1 file, it could be because `CmdletsToExport` are different for different platforms.
+
+* Also, we should never have files with the same names under "Full" and "Shared" (or "Core" and "Shared").