Doc/gh 747 - Updated Download link in Step 2 - Installing SAP Com with TUA SPA

Gemfile.lock

@@ -1,18 +1,18 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.0.2.1)
+    activesupport (6.0.3)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 0.7, < 2)
       minitest (~> 5.1)
       tzinfo (~> 1.1)
-      zeitwerk (~> 2.2)
+      zeitwerk (~> 2.2, >= 2.2.2)
     addressable (2.7.0)
       public_suffix (>= 2.0.2, < 5.0)
     algolia_html_extractor (2.6.2)
       json (~> 2.0)
       nokogiri (~> 1.10.4)
-    algoliasearch (1.27.1)
+    algoliasearch (1.27.2)
       httpclient (~> 2.8, >= 2.8.3)
       json (>= 1.5.1)
     coffee-script (2.4.1)
@@ -33,10 +33,10 @@ GEM
     eventmachine (1.2.7)
     eventmachine (1.2.7-x64-mingw32)
     execjs (2.7.0)
-    faraday (1.0.0)
+    faraday (1.0.1)
       multipart-post (>= 1.2, < 3)
-    ffi (1.11.1)
-    ffi (1.11.1-x64-mingw32)
+    ffi (1.12.2)
+    ffi (1.12.2-x64-mingw32)
     filesize (0.2.0)
     forwardable-extended (2.6.0)
     gemoji (3.0.1)
@@ -224,8 +224,8 @@ GEM
       jekyll (>= 3.5, < 5.0)
       jekyll-feed (~> 0.9)
       jekyll-seo-tag (~> 2.1)
-    minimal-mistakes-jekyll (4.18.1)
-      jekyll (>= 3.6, < 5.0)
+    minimal-mistakes-jekyll (4.19.2)
+      jekyll (>= 3.7, < 5.0)
       jekyll-feed (~> 0.1)
       jekyll-gist (~> 1.5)
       jekyll-include-cache (~> 0.1)
@@ -237,19 +237,20 @@ GEM
       mini_portile2 (~> 2.4.0)
     nokogiri (1.10.9-x64-mingw32)
       mini_portile2 (~> 2.4.0)
-    octokit (4.14.0)
+    octokit (4.18.0)
+      faraday (>= 0.9)
       sawyer (~> 0.8.0, >= 0.5.3)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
     progressbar (1.10.1)
     public_suffix (3.1.1)
-    rb-fsevent (0.10.3)
+    rb-fsevent (0.10.4)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
     rouge (3.13.0)
-    ruby-enum (0.7.2)
+    ruby-enum (0.8.0)
       i18n
-    rubyzip (2.2.0)
+    rubyzip (2.3.0)
     safe_yaml (1.0.5)
     sass (3.7.4)
       sass-listen (~> 4.0.0)
@@ -262,11 +263,11 @@ GEM
     terminal-table (1.8.0)
       unicode-display_width (~> 1.1, >= 1.1.1)
     thread_safe (0.3.6)
-    typhoeus (1.3.1)
+    typhoeus (1.4.0)
       ethon (>= 0.9.0)
-    tzinfo (1.2.6)
+    tzinfo (1.2.7)
       thread_safe (~> 0.1)
-    unicode-display_width (1.6.1)
+    unicode-display_width (1.7.0)
     verbal_expressions (0.1.5)
     wdm (0.1.1)
     zeitwerk (2.3.0)

_data/navigation.yml

@@ -232,11 +232,23 @@ docs:
 
     - title: Telco & Utilities Storefront Development Guide
       children:
-        - title: "About Telco & Utilities Storefront"
-          url: /about-telco/
-        - title: "Release Information"
-          url: /telco-release-information/
-
+          - title: "About TUA Spartacus"
+            url: /about-tua-spartacus/
+          - title: "Release Information for TUA Spartacus ➢"
+            url: /telco-release-information/
+            subchildren:
+                - title: "Pre-Release Information"
+                  url: /tua-pre-release-notes-next1/
+          - title: "Roadmap for TUA Spartacus"
+            url: /tua-spartacus-roadmap/
+          - title: "Getting Started with TUA Spartacus ➢"
+            url: /getting-started-with-tua-spartacus/ 
+            subchildren:
+                - title: "Installing SAP Commerce Cloud for use with TUA Spartacus."
+                  url: /installing-sap-commerce-for-tua-spartacus/
+                - title: "Building the TUA Spartacus Storefront from Libraries"
+                  url: /building-the-tua-storefront-from-libraries/                           
+
     - title: Contributing to Spartacus
       children:
           - title: "Contributor's Guide ➢"

_pages/telco/about-tua-spartacus.md

@@ -0,0 +1,7 @@
+---
+title: About TUA Spartacus
+---
+
+The telco and utilities accelerator for project "Spartacus" (TUA Spartacus) is a lean, Angular-based storefront for SAP Commerce working exclusively through the Commerce REST API. TUA Spartacus works with and enhances the Telco and Utilities Accelerator storefront. In addition to supporting Commerce REST APIs, the Telco and Utilities Accelerator supports TM Forum APIs for delivering industry-specific functionality.
+
+Service providers can deliver personalized and relevant user experiences tailored to the needs of their customers. The TUA storefront provides a future-proof technical foundation for growth, quick time-to-market, and a competitive advantage for delivering innovative capabilities. For more information, see [TUA Storefront](https://b2ctelco.avengers:9002/yacceleratorstorefront/b2ctelco/en/).

_pages/telco/building-the-tua-storefront-from-libraries.md

@@ -0,0 +1,259 @@
+---
+title: Building the TUA Spartacus Storefront from Libraries
+---
+
+The following instructions describe how to build a TUA storefront application using published TUA Spartacus 1.x libraries.
+
+**Note:** If you are building TUA Spartacus from source, see [Contributor Setup]({{ site.baseurl }}{% link _pages/contributing/contributor-setup.md %}).
+
+## Prerequisites
+
+Before carrying out the procedures below, ensure that you meet the following front-end and back-end requirements.
+
+## Front-End Development Requirements
+
+{% include docs/frontend_requirements.html %}
+
+### Installing or Updating the Prerequisite Development Tools
+
+There are a few ways you can install Angular and other prerequisite software. The following example installs yarn, node.js, and Angular CLI using [Homebrew](https://brew.sh), which was created for MacOS, but also works on Linux and Windows 10 (through the Linux subsystem feature). 
+
+To install the prerequisite development tools, install [Homebrew](https://brew.sh), and then run the following commands:
+
+```
+brew install yarn
+brew install node@10
+brew install angular-cli
+```
+
+To update existing installations, use `brew upgrade` instead of `brew install`.
+
+**Note:** 
+
+- If you have a later version of node.js installed in addition to v10, you can set v10 to be used with the following command:
+`brew link --force --overwrite node@10`.
+- Installing Homebrew and the prerequisites is beyond the scope of this document. You can also install the prerequisites using their individual installers.
+
+## Back End Server Requirements
+
+TUA Spartacus uses SAP Commerce and Telco & Utilities Accelerator for its back end, and makes use of the sample data from the Telco & Utilities Accelerator storefront in particular.
+
+- SAP Commerce version: Release 1905 (latest patch is recommended).
+- Telco & Utilities Accelerator version: Release 2003 (latest patch) is required.
+
+For more information, see [Installing SAP Commerce for use with TUA Spartacus]({{ site.baseurl }}{% link _pages/telco/installing-sap-commerce-for-tua-spartacus.md %}).
+
+## Creating a New Angular App
+
+To create a new Angular application with the name `mystore`, follow the procedure:
+
+1. Open a terminal or command prompt window at the location of your choice.
+
+2. Using the Angular CLI, generate a new Angular application with the following command:
+
+   ```bash
+   ng new mystore --style=scss
+   ```
+
+   When prompted if you would like to add Angular routing, enter `n` for 'no'.
+
+   The `mystore` folder and the new app are created.
+
+3.  Access the newly created `mystore` folder with the following command:
+
+     ```bash
+     cd mystore
+     ```
+
+## Project Setup
+
+The easiest way to start a new project and to quickly set up your application:
+
+Run `yarn start`.
+
+For a full list of available parameters, visit Spartacus schematics [documentation](https://github.com/SAP/cloud-commerce-spartacus-storefront/tree/develop/projects/schematics).
+
+## Setting up a Storefront Manually
+
+Although we recommend using Schematics, there might be situations when you want to build your application from scratch.
+
+The dependencies in this procedure are required by the TUA Spartacus storefront.
+
+1. Inspect the `mystore/src/app/app.module.ts` file for any changes you want to make for your setup. For example, you might want to change the `baseUrl` to point to your server and the `basesite` to corresond with the WCMS site. You likely also want to specify the compatibility version by changing `features.level`, as the default might not be the latest version.
+
+      To make use of the modules shipped with `tua-spa` library, the `app.module.ts` must have the following structure:
+
+      ```typescript
+      import {BrowserModule} from '@angular/platform-browser';
+      import {NgModule} from '@angular/core';
+      import {ConfigModule} from '@spartacus/core';
+      import {AppComponent} from './app.component';
+      import {translationChunksConfig, translations} from '@spartacus/assets';
+      import {TmaAuthModule, TmaB2cStorefrontModule, TmaProductSummaryModule, tmaTranslations, TmfModule} from '@spartacus/tua-spa';
+
+      @NgModule({
+        declarations: [
+          AppComponent
+        ],
+        imports: [
+          BrowserModule,
+          TmaAuthModule,
+          TmfModule.forRoot(),
+          TmaB2cStorefrontModule.withConfig({
+            backend: {
+              tmf: {
+                baseUrl: 'https://localhost:9002',
+                prefix: '/b2ctelcotmfwebservices/v2/',
+              },
+              occ: {
+                baseUrl: 'https://localhost:9002',
+                prefix: '/rest/v2/',
+                endpoints: {
+                  product_scopes: {
+                    details:
+                      'products/${productCode}?fields=averageRating,stock(DEFAULT),description,availableForPickup,code,url,price(DEFAULT),numberOfReviews,manufacturer,categories(FULL),priceRange,multidimensional,configuratorType,configurable,tags,images(FULL),productOfferingPrice(FULL),productSpecification,validFor',
+                  },
+                  productSearch:
+                    'products/search?fields=products(code,name,summary,price(FULL),images(DEFAULT),stock(FULL),averageRating,variantOptions,productSpecification),facets,breadcrumbs,pagination(DEFAULT),sorts(DEFAULT),freeTextSearch',
+                },
+              }
+            },
+            routing: {
+              routes: {
+                product: {
+                  paths: ['product/:productCode/:name', 'product/:productCode'],
+                }
+              }
+            },
+            context: {
+              urlParameters: ['baseSite', 'language', 'currency'],
+              baseSite: ['telcospa']
+            },
+            i18n: {
+              resources: translations,
+              chunks: translationChunksConfig,
+              fallbackLang: 'en'
+            },
+            features: {
+              level: '1.4'
+            }
+          }),
+          ConfigModule.withConfig({
+            i18n: {
+              resources: tmaTranslations
+            }
+          }),
+          TmaProductSummaryModule,
+        ],
+        providers: [],
+        bootstrap: [AppComponent]
+      })
+      export class AppModule {
+      }
+      ```
+
+2. Replace the entire contents of `mystore/src/app/app.component.html with <cx-storefront>Loading...</cx-storefront>` with:
+
+   ```html
+   <cx-storefront>Loading...</cx-storefront>
+   ```
+
+3. Open `mystore/package.json` using a text editor.
+
+4. Add the following dependencies to the end of the `dependencies` section of `package.json`.
+
+    ```json
+    "@angular/pwa": "^0.803.2",
+    "@angular/service-worker": "~8.2.5",
+    "@ng-bootstrap/ng-bootstrap": "5.1.0",
+    "@ng-select/ng-select": "^3.0.7",
+    "@ngrx/effects": "~8.3.0",
+    "@ngrx/router-store": "~8.3.0",
+    "@ngrx/store": "~8.3.0",
+    "ngx-infinite-scroll": "^8.0.0",
+    "bootstrap": "^4.2.1",
+    "i18next": "^15.0.6",
+    "i18next-xhr-backend": "^2.0.1",
+    "material-design-icons": "^3.0.1",
+
+    "@spartacus/core": "~1.5.0",
+    "@spartacus/styles": "~1.5.0",
+    "@spartacus/storefront": "~1.5.0",
+    "@spartacus/assets": "~1.5.0",
+    "@spartacus/styles": "~1.5.0",
+    "@spartacus/tua-spa": "~0.1.0-next.2",
+   ```
+
+    **Note:** Make sure to add a comma to the end of the last dependency statement listed in this section. For example, the last statement in your new app might be `"zone.js": "~0.9.1"` so you need to add a comma after `0.9.1"`.
+
+5. Make sure that the following import is found in the  `mystore/src/styles.scss`:
+
+    ```bash
+   @import '~@spartacus/styles/index';
+   @import '~@spartacus/tua-spa/storefrontstyles/index';
+    ```
+
+6. From the terminal window, within `mystore`, install the dependencies by running the following command:
+
+   ```bash
+   yarn install
+   ```
+
+7. Start the angular client app. From the terminal window, within `mystore` start the application by running the following command:
+
+   ```bash
+   yarn start
+   ```
+
+8. Make sure your backend server is up and running (SAP Commerce with TUA). When the backend server is properly started, point your browser to http://localhost:4200/telcospa/en/usd.
+
+**Note:**
+
+(1) Using `~` instructs yarn to use the latest patch version (x.y.**z**); whereas, using `^` instructs yarn to use the latest minor version (x.**y**.0).
+
+(2) If you are updating an existing app, and changing dependencies, it is recommended to delete the `node_modules` folder before running the install command.
+
+### Adding Import Declarations and Storefront Configuration Settings
+
+**Note:** Some statements in the preceding example were generated by Angular when you first created the app.
+
+#### About the Import Statements
+
+The import statements import either modules or default data needed by TUA Spartacus.
+
+## Building and Starting
+
+This section describes how to validate your back-end installation and start the application with the storefront enabled.
+
+## Validating the SAP Commerce Back End
+
+**Note:** The Chrome browser is recommended and used in the following example, but other browsers can be used as long as they recognize and allow you to continue even though a site is using a self-signed certificate.
+
+1. Use a web browser to access the OCC endpoint of your backend.
+
+   The default is available at: `{server-base-url}/rest/v2/electronics/cms/pages`
+
+   For example, you can access:
+   https://localhost:9002/rest/v2/telcospa/cms/pages with a back-end instance running from `https://localhost:9002`.
+
+2. Accept the security exception in your browser if you are running a development instance with a self-signed HTTPS certificate.
+
+    When the request works, you will see an XML response in your browser.
+
+### Starting the Storefront Application
+
+To start your TUA Spartacus storefront, enter the following command from `mystore` in your terminal window:
+
+   ```bash
+yarn start
+   ```
+
+   When the app server is properly started, point your browser to http://localhost:4200.
+
+Or, to start your TUA Spartacus storefront securely, enter the following command:
+
+   ```bash
+yarn start --ssl
+   ```
+
+Then point your browser to  https://localhost:4200.