From 94ea274c6b30c2b938d4d12c4bf1444970fbcb39 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 5 Jul 2022 12:26:14 +0000 Subject: [PATCH 1/4] Bump nokogiri from 1.12.5 to 1.13.6 Bumps [nokogiri](https://github.com/sparklemotion/nokogiri) from 1.12.5 to 1.13.6. - [Release notes](https://github.com/sparklemotion/nokogiri/releases) - [Changelog](https://github.com/sparklemotion/nokogiri/blob/main/CHANGELOG.md) - [Commits](https://github.com/sparklemotion/nokogiri/compare/v1.12.5...v1.13.6) --- updated-dependencies: - dependency-name: nokogiri dependency-type: direct:development update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] --- Gemfile.lock | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index 0f3049bbec..a994a6f08d 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -105,12 +105,12 @@ GEM rb-fsevent (~> 0.10, >= 0.10.3) rb-inotify (~> 0.9, >= 0.9.10) mercenary (0.3.6) - mini_portile2 (2.6.1) + mini_portile2 (2.8.0) minitest (5.15.0) - nokogiri (1.12.5) - mini_portile2 (~> 2.6.1) + nokogiri (1.13.6) + mini_portile2 (~> 2.8.0) racc (~> 1.4) - nokogiri (1.12.5-x86_64-darwin) + nokogiri (1.13.6-x86_64-darwin) racc (~> 1.4) nokogumbo (2.0.5) nokogiri (~> 1.8, >= 1.8.4) From 64cb3f4c55f0caab1050782a7666ff8ed5dfd8e5 Mon Sep 17 00:00:00 2001 From: Jens Oliver Meiert Date: Thu, 11 Nov 2021 22:44:08 +0100 Subject: [PATCH 2/4] docs: improve NodeAgent SDK documentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * improved formatting * correct heading * add missing link (please verify) * replaced “here” links by in-copy links * switched to list for API call reasons Signed-off-by: Jens Oliver Meiert --- .../APIGuidelines/important-updates.md | 22 ++++++++++--------- 1 file changed, 12 insertions(+), 10 deletions(-) diff --git a/pages/Documents/APIGuidelines/important-updates.md b/pages/Documents/APIGuidelines/important-updates.md index 8d5e63404a..3965cf44c1 100644 --- a/pages/Documents/APIGuidelines/important-updates.md +++ b/pages/Documents/APIGuidelines/important-updates.md @@ -11,21 +11,23 @@ indicator: both --- ### Messaging Agent SDK upgrade available -LivePerson empowers external Bot Vendors and Bot Builders to build fully customized bots with LivePerson's Conversational Cloud, leveraging the Messaging Agent SDK for node.js. -We’re excited to share that we have released a new version of NodeAgentSDK which will improve resilience and stability of your third-party bots. Please upgrade to the new NodeAgent SDK as soon as possible to realize these improvements. For the latest SDK version, click here. -With the upgrade to the latest version, we recommend auditing your integration to ensure compliance with the best practices around managing connections with LivePerson’s Conversational Cloud. Click [here](https://github.com/LivePersonInc/node-agent-sdk/wiki/NodeAgentSDK-Connection-Best-Practices) for the best practices. +LivePerson empowers external Bot Vendors and Bot Builders to build fully customized bots with LivePerson's Conversational Cloud, leveraging the Messaging Agent SDK for node.js. + +We’re excited to share that we have released a new version of NodeAgent SDK which will improve resilience and stability of your third-party bots. Please upgrade to the [new NodeAgent SDK](https://github.com/LivePersonInc/node-agent-sdk) as soon as possible to realize these improvements. + +With the upgrade to the latest version, we recommend auditing your integration to ensure compliance with the [best practices](https://github.com/LivePersonInc/node-agent-sdk/wiki/NodeAgentSDK-Connection-Best-Practices) around managing connections with LivePerson’s Conversational Cloud. ### Messaging/Engagement History API - Adding source name to API calls -As part of our continuous effort to improve troubleshooting and reporting in the historical and operational APIs, we are planning to require a 'source name’ parameter as part of any API calls. This will apply for both internal and external calls. +As part of our continuous effort to improve troubleshooting and reporting in the historical and operational APIs, we are planning to require a `source name` parameter as part of any API calls. This will apply for both internal and external calls. -Why do we require a source name in an API call? -Align with API standards, source name is a common practice when building data APIs. -Improve monitoring and better control over the traffic. This change will improve the ability to take data-driven actions based on customer source and not by all customer traffic. For example throttling per source. -Secure and identify unwanted traffic. -Provide more accurate traffic reports to brands. +### Why do we require a source name in an API call? +* Align with API standards, source name is a common practice when building data APIs. +* Improve monitoring and better control over the traffic. This change will improve the ability to take data-driven actions based on customer source and not by all customer traffic. For example throttling per source. +* Secure and identify unwanted traffic. +* Provide more accurate traffic reports to brands. ### What are the APIs in scope? -All historial API consumers +All historial API consumers: * [Messaging Interactions API](https://developers.liveperson.com/messaging-interactions-api-overview.html) * [Engagement History API](https://developers.liveperson.com/engagement-history-api-overview.html) From 2821ef5cfd126ab64a4b2acd275d872a138cdb4b Mon Sep 17 00:00:00 2001 From: Jens Oliver Meiert Date: Fri, 8 Jul 2022 11:24:23 +0200 Subject: [PATCH 3/4] docs: add extra installation pointer, and improve formatting and punctuation Signed-off-by: Jens Oliver Meiert --- README.md | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index c138499c55..70c87c6c93 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ **This site is maintained by LivePerson’s Developer Experience team. Please contact dx-lp@liveperson.com for issues, comments, or questions.** -This repository generates LivePerson's Developer Center, which can be found at [developers.liveperson.com](https://developers.liveperson.com/). The site is generated using [Jekyll](https://jekyllrb.com/). If you find an issue with the documentation, site structure, meta or anything else, please open an issue and we'll respond as soon as possible. +This repository generates LivePerson’s Developer Center, which can be found at [developers.liveperson.com](https://developers.liveperson.com/). The site is generated using [Jekyll](https://jekyllrb.com/). If you find an issue with the documentation, site structure, meta or anything else, please open an issue and we’ll respond as soon as possible. **Table of Contents** @@ -42,7 +42,7 @@ E.G documentname: `Add Agent Widgets` should be a folder with name `AddAgentWidg #### How to Understand the documentsupdated yaml File Example Normal Layout: - + - categoryname: Agent Experience image: agent-experience-new documents: @@ -62,7 +62,7 @@ Example Normal Layout: basedomain: https://{domain}/api/account/{accountId}/agentSession pages: - pagename: Overview - + The Top layer 0 in this structure is the category name Agent Experience. Its folder name is`AgentExperience`. Add Agent Widgets is a folder in layer 1 with path `AgentExperience/AddAgentWidgets` The Add Agent Widgets folder only contains one page in it. `AgentExperience/AddAgentWidgets/add-your-own-widgets-to-the-agent-workspace.md` @@ -120,7 +120,7 @@ Example Documentname is pagename: 1. Documentname name is `Getting Started with your Free Trial Account` is not a folder name becauase it does not contain a pages key below it 2. Since this above file only contains one parent, there should not be a document name in the file `getting-started-with-your-free-trial-account.md` -3. The pagename for `getting-started-with-your-free-trial-account.md` must match the documentname in the yaml file `Getting Started with your Free Trial Account` +3. The pagename for `getting-started-with-your-free-trial-account.md` must match the documentname in the yaml file `Getting Started with your Free Trial Account` #### Environments @@ -132,7 +132,7 @@ To updated production and staging enviornments, create a pull request for master #### Updating/Creating Headers -Jekyll uses a [front-matter](https://jekyllrb.com/docs/frontmatter/) to arrange and define the various documents in the site. This is the text which appears in between the “---” at the top of each document. It's technically a YAML snippet, so all [YAML formatting](http://www.yamllint.com/) and rules apply to it. Our headers are usually comprised of the following key/value pairs: +Jekyll uses a [front-matter](https://jekyllrb.com/docs/frontmatter/) to arrange and define the various documents in the site. This is the text which appears in between the “---” at the top of each document. It’s technically a YAML snippet, so all [YAML formatting](http://www.yamllint.com/) and rules apply to it. Our headers are usually comprised of the following key/value pairs: * `pagename`: This is the name of the page that will appear at the top of the document. @@ -140,7 +140,7 @@ Jekyll uses a [front-matter](https://jekyllrb.com/docs/frontmatter/) to arrange * `sitesection`: This key accepts either `Documents` or `Solutions`. This designates which part of the site the document is under. -* `categoryname`: This is the category to which the document's API belongs (for example, the “Create Users” method belongs to the Users API which is under Contact Center Management). +* `categoryname`: This is the category to which the document’s API belongs (for example, the “Create Users” method belongs to the Users API which is under Contact Center Management). * `documentname`: This is the API to which the document belongs. @@ -160,16 +160,16 @@ Jekyll uses a [front-matter](https://jekyllrb.com/docs/frontmatter/) to arrange * Add the Files to the Hidden->Hidden folder. * Do not include them to documentsupdated.yaml file. -* Make sure Layout header is set to `hidden-layout` (This specifically makes it so search engines can't find it) +* Make sure Layout header is set to `hidden-layout` (This specifically makes it so search engines can’t find it) * Make sure that the headers are set correctly follow the file header structure of `blank.md` in the Hidden->Hidden folder **Any other parameters which are not documented here which you might find in the front-matter are deprecated and are only present for backwards compatibility purposes. These should not be used**. #### Adding New Documents to the Sidebar -Once you've created a new document, you'll need to have it manually added. We chose a manual process for the sidebar for a few reasons. First, it reduces the fragility of the sidebar (the extra, manual step gives us another layer of QA). Secondly, it increases the flexibility of the sidebar (we write code once and then maintain a YAML file, making it easier to add options). Lastly, it decreases site build times (since the `forloops` needed to dynamically build a sidebar in a site of our size and complexity are time and resource consuming). +Once you’ve created a new document, you’ll need to have it manually added. We chose a manual process for the sidebar for a few reasons. First, it reduces the fragility of the sidebar (the extra, manual step gives us another layer of QA). Secondly, it increases the flexibility of the sidebar (we write code once and then maintain a YAML file, making it easier to add options). Lastly, it decreases site build times (since the `forloops` needed to dynamically build a sidebar in a site of our size and complexity are time and resource consuming). -The sidebar's YAML file can be found in the `_data` folder. It's called `documentsupdated.yaml`. You **must** make sure the name of the file and the pagename in the sidebar correspond; the link the sidebar sends to is auto-generated and **must** match the `permalink` in the file's header (see above). Please make sure the Markdown file created contains its pagename, documentname, categoryname, and permalink in its header. The Markdown file might need more information depending on where it will need to be in the sidebar. +The sidebar’s YAML file can be found in the `_data` folder. It’s called `documentsupdated.yaml`. You **must** make sure the name of the file and the pagename in the sidebar correspond; the link the sidebar sends to is auto-generated and **must** match the `permalink` in the file’s header (see above). Please make sure the Markdown file created contains its pagename, documentname, categoryname, and permalink in its header. The Markdown file might need more information depending on where it will need to be in the sidebar. The max width for an image in this repo is 800px. @@ -177,15 +177,15 @@ The max width for an image in this repo is 800px. **IMPORTANT:** This repository requires Ruby 2.7.x. Attempts to run the local server on 3.x.x will generate confusing errors. -If you have not already done so, make sure your computer has Ruby installed. Here's a helpful guide on how best do that on [Mac](http://railsapps.github.io/installrubyonrails-mac.html) (you can stop once Ruby is installed, you don't need Rails) and on [any other system](https://www.ruby-lang.org/en/documentation/installation/). +If you have not already done so, make sure your computer has Ruby installed. Here’s a helpful guide on how best do that on [Mac](http://railsapps.github.io/installrubyonrails-mac.html) (you can stop once Ruby is installed, as you don’t need Rails) and on [any other system](https://www.ruby-lang.org/en/documentation/installation/). Another good resource is [Jekyll’s installation guide](https://jekyllrb.com/docs/installation/macos/), with the only difference being to have `chruby` point to a different version of Ruby (like 2.7.6). -Once you have installed Ruby, clone this repository to your machine. Once done, navigate to it using Terminal or your preferred command line interface. Follow the steps below to run the site from your machine. **If you're on Windows, don't forget to run your CLI as an admin.** +Once you have installed Ruby, clone this repository to your machine. Once done, navigate to it using Terminal or your preferred command line interface. Follow the steps below to run the site from your machine. **If you’re on Windows, don’t forget to run your CLI as an admin.** **First time install** 1. Run `npm install` 2. Run `npm run serve` -3. Navigate to http://localhost:4000/ (or the port you chose) and you'll see the site. +3. Navigate to http://localhost:4000/ (or the port you chose) and you’ll see the site. **OSX Installation** @@ -196,9 +196,9 @@ Once you have installed Ruby, clone this repository to your machine. Once done, You have two options to run the site locally after the first install: -* **Using gulp.js**. [Gulp](https://gulpjs.com/) is a toolkit for automating painful or time-consuming tasks. By simply typing in `gulp` in your command line, it takes care of all the build commands needed to serve the site. It also watches the root directory and will automatically refresh your browser once any changes were built. Gulp and its dependencies are installed locally in the project, so there's no further installation needed from your end. +* **Using gulp.js**. [Gulp](https://gulpjs.com/) is a toolkit for automating painful or time-consuming tasks. By simply typing in `gulp` in your command line, it takes care of all the build commands needed to serve the site. It also watches the root directory and will automatically refresh your browser once any changes were built. Gulp and its dependencies are installed locally in the project, so there’s no further installation needed from your end. -* **Using Jekyll's standard commands**. All you need to run in consequent builds of the site is `bundle exec jekyll serve`. You can add the suffix `--incremental` to enable incremental building of the site. This saves build times since the regeneration feature is enabled by default (the site rebuilds every time you hit “save”). When `--incremental` is used, Jekyll won't rebuild the entire site on every save, only the affected sections. If you'd like the project to automatically open in a new tab, you can add the `-o` flag to the end of the above command. +* **Using Jekyll’s standard commands**. All you need to run in consequent builds of the site is `bundle exec jekyll serve`. You can add the suffix `--incremental` to enable incremental building of the site. This saves build times since the regeneration feature is enabled by default (the site rebuilds every time you hit “save”). When `--incremental` is used, Jekyll won’t rebuild the entire site on every save, only the affected sections. If you’d like the project to automatically open in a new tab, you can add the `-o` flag to the end of the above command. **Note**: changes that alter site navigation or other changes that change the site as a whole might not show up when using `--incremental`. If that occurs, simply “kill” the build and run `bundle exec jekyll serve` without the suffix. **This is also true for gulp: you will need to kill your gulp instance and then run the direct Jekyll command**. From 4b6810ab8af3d90f092ebc6c853a6d33a1bc5d1f Mon Sep 17 00:00:00 2001 From: Jens Oliver Meiert Date: Fri, 8 Jul 2022 11:27:09 +0200 Subject: [PATCH 4/4] chore: re-install --- package-lock.json | 1 - 1 file changed, 1 deletion(-) diff --git a/package-lock.json b/package-lock.json index b5d15bc137..71391f1aa3 100644 --- a/package-lock.json +++ b/package-lock.json @@ -5,7 +5,6 @@ "requires": true, "packages": { "": { - "name": "developers-community", "version": "1.0.0", "license": "ISC", "dependencies": {