Update doc to new version and change import export page (#22)

* Update doc to new version and change import export page

Author: michelu89

core/libs/editor/src/lib/editor-toolbar/components/help/document.component.ts

@@ -21,7 +21,7 @@ import {MatDialogRef} from '@angular/material/dialog';
   styleUrls: ['./document.component.scss'],
 })
 export class DocumentComponent {
-  AMEDocumentationLink = 'https://openmanufacturingplatform.github.io/sds-documentation/ame-guide/4.2.0/introduction.html';
+  AMEDocumentationLink = 'https://openmanufacturingplatform.github.io/sds-documentation/ame-guide/4.2.1/introduction.html';
   BAMMDocumentationLink = 'https://openmanufacturingplatform.github.io/sds-documentation/bamm-specification/2.0.0/index.html';
 
   constructor(private dialogRef: MatDialogRef<DocumentComponent>, @Inject(APP_CONFIG) public config: AppConfig) {

documentation/ame-guide/antora.yml

@@ -1,6 +1,6 @@
 name: ame-guide
 title: Aspect Model Editor
-version: "4.2.0"
+version: "4.2.1"
 start_page: ROOT:introduction.adoc
 nav:
   - modules/ROOT/nav.adoc

documentation/ame-guide/modules/ROOT/images/replace-import.png

@@ -13,7 +13,7 @@
 * xref:validation-and-notifications.adoc[Validation and notifications]
 * xref:model-versions.adoc[Aspect Model versions]
 * xref:namespaces-references.adoc[Namespaces and external references]
-* xref:import-and-export-namespaces.adoc[Import and export namespaces]
+* xref:import-and-export-namespaces.adoc[Import and export a namespace]
 * xref:use-external-references.adoc[Use external references]
 * xref:generate-json.adoc[Generate JSON]
 * xref:support.adoc[Support]

documentation/ame-guide/modules/ROOT/images/validation-result.png

@@ -1,14 +1,14 @@
 :page-partial:
 
-[[import-export-namespaces]]
-= Import and export namespaces
+[[import-export-namespace]]
+= Import and export a namespace
 
 For general information on external references, see xref:namespaces-references.adoc#namespaces-external-references[Namespaces and external references].
 
-[[import-namespaces]]
-== Import namespaces
+[[import-namespace]]
+== Import namespace
 
-To import a package with namespaces, proceed as follows:
+To import a package with one single namespace, proceed as follows:
 
 . Click *New/Load* in the xref:ui-overview.adoc#toolbar[toolbar].
 . Click *Import Package*.
@@ -34,9 +34,8 @@ image::replace-import.png[width=80%]
 
 → Now your namespaces are added to the recent model.
 
-
 [[export-namespace]]
-== Export namespaces
+== Export namespace
 
 To export a namespace, proceed as follows:
 
@@ -49,7 +48,8 @@ To export a namespace, proceed as follows:
 image::select-namespace-export.png[width=100%]
 . Click *Validate*.
 +
-→ After validation is done, a summary dialog similar to the one for xref:import-and-export-namespaces.adoc#import-namespaces[namespace import] will be displayed. If the validation has files with errors, the namespace cannot be exported.
+→ After validation is done, a summary dialog similar to the one for xref:import-and-export-namespaces.adoc#import-namespace[namespace import] will be displayed.
+If the validation has files with errors, the namespace cannot be exported.
 +
 image::export-window.png[width=100%]
 . Click *Export*.

documentation/ame-guide/modules/ROOT/nav.adoc

@@ -3,17 +3,19 @@
 [[namespaces-external-references]]
 = Namespaces and external references
 
-The Aspect Model Editor supports external references and custom namespaces. The namespaces from which the external elements can be referenced are defined by the folder structure of the Aspect Model Editor file directory.
+The Aspect Model Editor supports external references and custom namespaces.
+The namespaces from which the external elements can be referenced are defined by the folder structure of the Aspect Model Editor file directory.
 
 [[file-directory-folder-structure]]
 == File directory and folder structure on your local machine
 
-By default, the Aspect Model Editor file directory is located at: 
+By default, the Aspect Model Editor file directory is located at:
 
 * `+C:\Users\<YOUR-USER-NAME>\aspect-model-editor+` (on Windows)
-* `+/Users/<YOUR-USER-NAME>/aspect-model-editor+` (on Mac or Linux)
+* `+/Users/<YOUR-USER-NAME>/aspect-model-editor+` (on Mac)
+* `/home/<YOUR-USER-NAME>/aspect-model-editor+` (on Linux)
 
-Here you can add the folder structure for your external references which will then show up in the xref:ui-overview.adoc#workspace-sidebar[Workspace sidebar]. 
+Here you can add the folder structure for your external references which will then show up in the xref:ui-overview.adoc#workspace-sidebar[Workspace sidebar].
 
 image::namespace-file-structure.png[width=100%]
 
@@ -32,7 +34,7 @@ image::file-elements.png[width=100%]
 
 For more information, see also:
 
-* xref:import-and-export-namespaces.adoc[Import and export namespaces]
+* xref:import-and-export-namespaces.adoc[Import and export a namespace]
 * xref:use-external-references.adoc[Use external references]
 
 ++++

documentation/ame-guide/modules/ROOT/pages/import-and-export-namespaces.adoc

@@ -10,7 +10,7 @@ For general information on external references, see xref:namespaces-references.a
 
 To add external references, proceed as follows:
 
-1. xref::import-and-export-namespaces.adoc#import-namespaces[Import the namespace] you want to use.
+1. xref::import-and-export-namespaces.adoc#import-namespace[Import the namespace] you want to use.
 2. Open the Workspace sidebar.
 3. Double-click the TTL file from which you want to use elements from.
 4. Drag the specific element and drop it to the graph area canvas.
@@ -19,19 +19,22 @@ image::external-reference-drag-and-drop.png[width=100%]
 +
 [NOTE]
 ====
-External references can only be dragged once into the current Aspect Model. These elements are marked with a lock sign signifying that they cannot be edited. You can only edit an external reference by editing the file it is defined in.
+External references can only be dragged once into the current Aspect Model.
+These elements are marked with a lock sign signifying that they cannot be edited.
+You can only edit an external reference by editing the file it is defined in.
 
 image::external-reference.png[width=100%]
 ====
 +
 [NOTE]
 ====
-When you drag and drop an external reference, it will also include all the lower connections (dependencies) of the element. Same goes for deleting the element – all dependencies will be deleted as well.
+When you drag and drop an external reference, it will also include all the lower connections (dependencies) of the element.
+Same goes for deleting the element – all dependencies will be deleted as well.
 
 image::external-reference-delete.png[width=100%]
 ====
-→ An external reference has now been added to your model.
 
+→ An external reference has now been added to your model.
 
 [[refer-to-another-element]]
 == Refer from one element to another one
@@ -43,9 +46,9 @@ To refer from one element to another one, proceed as follows:
 . Click *Save*.
 . Click *Save to namespace*.
 +
-→  Now the reference can be found in the xref:ui-overview.adoc#workspace-sidebar[Workspace sidebar].
+→ Now the reference can be found in the xref:ui-overview.adoc#workspace-sidebar[Workspace sidebar].
 . xref::load-and-save-models.adoc#load-start-new-models[Load or start] a new model.
-. xref::import-and-export-namespaces.adoc#import-export-namespaces[Open] the Workspace sidebar.
+. xref::import-and-export-namespaces.adoc#import-export-namespace[Open] the Workspace sidebar.
 . Double-click the TTL file of which you want to use elements from.
 . Drag the specific element and drop it on the graph area canvas.