mimic phrasea /doc dir, + some translation & order as example.

Author: jygaulier

databox/api/Command/DocumentationDumperCommand.php

@@ -23,15 +23,14 @@ protected function execute(InputInterface $input, OutputInterface $output): int
         $destination = Path::join(__DIR__, '../doc');
 
         $filesystem->copy("$source/Databox-api_dynamic.md", "$destination/Databox-api_dynamic.md", true);
-        $filesystem->mirror("$source/Databox/Api/", "$destination/Databox/Api/");
-        $filesystem->mirror("$source/Databox/Attributes/", "$destination/Databox/Attributes/");
-        $filesystem->mirror("$source/Databox/Renditions/", "$destination/Databox/Renditions/");
+        $filesystem->mirror("$source/Api/", "$destination/Api/");
+        $filesystem->mirror("$source/Attributes/", "$destination/Attributes/");
+        $filesystem->mirror("$source/Renditions/", "$destination/Renditions/");
 
         file_put_contents(Path::join($destination, 'STAMP.md'), date(DATE_ATOM));
 
         $output->writeln("databox-api/doc dynamic files generated");
 
         return Command::SUCCESS;
     }
-
 }

…_preGeneratedDoc/Databox/Api/schema.json …box/api/_preGeneratedDoc/Api/schema.jsondatabox/api/_preGeneratedDoc/Databox/Api/schema.json renamed to databox/api/_preGeneratedDoc/Api/schema.json databox/api/_preGeneratedDoc/Databox/Api/schema.json renamed to databox/api/_preGeneratedDoc/Api/schema.json

@@ -1,3 +1,8 @@
-This file `Databox.api_dynamic.md` has been generated in `/databox/api/doc/` by the `DocumentationDumper` command.
+## databox-api dynamic generated files
 
-The command also generates a `Databox` subdirectory in the same place.
+This file was found in the subdirectory `Databox/`
+of the `/doc/` directory of the `databox-api-php` image.
+
+It has been generated by the `DocumentationDumper` command during the build of the image.
+
+The command also generated a `Api`, `Attributes` and `Renditions` subdirectory in the same place.

…x/Attributes/initial_attribute_values.md …c/Attributes/initial_attribute_values.mddatabox/api/_preGeneratedDoc/Databox/Attributes/initial_attribute_values.md renamed to databox/api/_preGeneratedDoc/Attributes/initial_attribute_values.md databox/api/_preGeneratedDoc/Databox/Attributes/initial_attribute_values.md renamed to databox/api/_preGeneratedDoc/Attributes/initial_attribute_values.md

@@ -0,0 +1,6 @@
+# Databox-api_static.md
+This file was found in the directory `doc/foo/bar/` of the `databox-api-php` image.
+
+The `doc` directory also contain
+dirs/files created by the `DocumentationDumper` command
+during the build of the image.