ENDOC-412 Create landing page for solution templates #395

Lyd1aCla1r3 · 2022-01-21T22:53:03Z

First pass at Solution Template page; ignore broken links pending left nav

jyunmitch · 2022-01-25T14:17:35Z

vuepress/docs/v6.3.2/tutorials/samples/landing-page.md

+
+## Overview
+
+The Entando Application Composition Platform offers four Solution Templates to demonstrate various business capabilities and integrations. Each Solution Template provisions the building blocks and structure scoped for a particular implementation. 


various >> wide range
It might be good to point out that these were built with Entando

four -> several so we don't need to update the number each time.

"Each Solution Template provisions the building blocks and structure scoped for a particular implementation. " -> "Each Open Source Solution Template can be used as-is, reviewed for common development practices, or considered a useful starting point for a related application. "

jyunmitch · 2022-01-25T14:19:15Z

vuepress/docs/v6.3.2/tutorials/samples/landing-page.md

+
+The Entando Application Composition Platform offers four Solution Templates to demonstrate various business capabilities and integrations. Each Solution Template provisions the building blocks and structure scoped for a particular implementation. 
+
+Solution Templates are available in the [public Entando Hub](http://hubdev.okd-entando.org/entando-de-app/en/test.page#/) for installation in a user environment, where turnkey functionality can be customized and extended.


I think the links should come above this, so they can see as many of the solution templates before needing to scroll.

"Solution Templates" -> "The following Solution Templates and other sets of components are available...."

Let's switch the link to hub.entando.com. I'm working to get that activated for the new Hub page on the web site soon, probably about the same time we publish the new navigation structure.

jyunmitch · 2022-01-25T14:23:15Z

vuepress/docs/v6.3.2/tutorials/samples/landing-page.md

+
+## Solution Template Details
+
+Specific features and use cases are highlighted below:


I don't think the header or this line is needed, I think this page should focus on the templates and get people directly to them

jyunmitch · 2022-01-25T14:42:26Z

vuepress/docs/v6.3.2/tutorials/samples/landing-page.md

+Specific features and use cases are highlighted below:
+
+- **Entando Customer Portal**:\
+Streamlines development of a customer-facing subscription management platform for a modern self-service experience. The framework consists of Jira Service Management integration for ticketing and tracking, RBAC identity supervision, and integrated management of subscriptions, projects and users.


This intro is rather hard to understand. The hub intro below is really effective, maybe style this one similarly, with emphasis on the subscription and service ticket management and RBAC user role supervision.

jyunmitch · 2022-01-25T14:43:50Z

vuepress/docs/v6.3.2/tutorials/samples/landing-page.md

+Streamlines development of a customer-facing subscription management platform for a modern self-service experience. The framework consists of Jira Service Management integration for ticketing and tracking, RBAC identity supervision, and integrated management of subscriptions, projects and users.
+
+- [**Entando Hub**](hub.md):\
+Installing a Hub instance empowers a team to share and collaborate on proprietary or Entando Open Source components. Capabilities, versions and metadata can be transparently analyzed, managed and published.


The Hub empowers a team to share...

i think it's important to differentiate between public and user instances of the hub, but user installation was already mentioned so we can take out the reference here

jyunmitch · 2022-01-25T14:47:55Z

vuepress/docs/v6.3.2/tutorials/samples/landing-page.md

+Installing a Hub instance empowers a team to share and collaborate on proprietary or Entando Open Source components. Capabilities, versions and metadata can be transparently analyzed, managed and published.
+
+- [**Entando Process Driven Applications Plugin**](pda-tutorial.md):\
+Provides a comprehensive and versatile automation scheme to manage and complete business processes. Resources and mechanisms comprise a custom UX layer, a Spring Boot Backend for Frontend microservice interface, and integration with the [Red Hat Process Automation Manager](https://www.redhat.com/en/technologies/jboss-middleware/process-automation-manager).


"It comprises a custom UX layer, a Spring..."

I think it might be better to provide examples of what it can do as opposed to what it was built with, especially for the general audience who is investigating what the entando platform is

specific examples like mortgage forms run the risk of derailing from an all-encompassing overview and a focus on flexibility; that would also require lengthening the description quite a bit. rewording to "Provides a comprehensive and versatile automation scheme for Business Process Management" should add any missing clarification and will also reduce the character count...

jyunmitch · 2022-01-25T14:59:50Z

vuepress/docs/v6.3.2/tutorials/samples/landing-page.md

+Provides a comprehensive and versatile automation scheme to manage and complete business processes. Resources and mechanisms comprise a custom UX layer, a Spring Boot Backend for Frontend microservice interface, and integration with the [Red Hat Process Automation Manager](https://www.redhat.com/en/technologies/jboss-middleware/process-automation-manager).
+
+- [**Entando Standard Banking Demo**](install-standard-demo.md):\
+Showcases modularity benefits and composability innovation as implemented by the Entando platform. Prominent features include RBAC Keycloak integration, coexistence of React and Angular MFEs, pluggable Spring Boot microservices, and sophisticated MFE communication techniques.


the words modularity and composability are great succinct words but kind of hard to understand what it actually is.

i think if the reader has gotten to the point where they're interested in solution templates they are definitely familiar with the concepts of modularity and composability...

Sorry, but I do have to disagree. After hearing Vandhana, I think some people, maybe only a few will come to this point to explore what Entando can do in terms of providing solutions to specific application. We can talk more about it on Friday!

nshaw · 2022-01-25T19:57:14Z

vuepress/docs/v6.3.2/tutorials/samples/landing-page.md

+
+## Overview
+
+The Entando Application Composition Platform offers four Solution Templates to demonstrate various business capabilities and integrations. Each Solution Template provisions the building blocks and structure scoped for a particular implementation. 


four -> several so we don't need to update the number each time.

"Each Solution Template provisions the building blocks and structure scoped for a particular implementation. " -> "Each Open Source Solution Template can be used as-is, reviewed for common development practices, or considered a useful starting point for a related application. "

nshaw · 2022-01-25T20:02:21Z

vuepress/docs/v6.3.2/tutorials/samples/landing-page.md

+
+The Entando Application Composition Platform offers four Solution Templates to demonstrate various business capabilities and integrations. Each Solution Template provisions the building blocks and structure scoped for a particular implementation. 
+
+Solution Templates are available in the [public Entando Hub](http://hubdev.okd-entando.org/entando-de-app/en/test.page#/) for installation in a user environment, where turnkey functionality can be customized and extended.


"Solution Templates" -> "The following Solution Templates and other sets of components are available...."

Let's switch the link to hub.entando.com. I'm working to get that activated for the new Hub page on the web site soon, probably about the same time we publish the new navigation structure.

nshaw · 2022-01-25T20:04:07Z

vuepress/docs/.vuepress/v632.js

@@ -305,6 +305,10 @@ module.exports = {
                        title: 'Process Driven Applications (PDA)',
                        path: path  + 'samples/pda-tutorial.md',
                    },
+                    {


I think it should be the default page for the Solution Templates section.

nshaw · 2022-01-25T20:05:40Z

vuepress/docs/v6.3.2/tutorials/samples/landing-page.md

+
+Specific features and use cases are highlighted below:
+
+- **Entando Customer Portal**:\


I like the flow overall but I do think including a thumbnail would be useful. We could even just use the actual thumbnails I have on the Hub itself if you want. That would be more generic, still add a little flair to the page, and let us save the full screenshots for the detailed pages.

jyunmitch · 2022-01-26T22:56:53Z

vuepress/docs/v6.3.2/tutorials/samples/landing-page.md


-Solution Templates are available in the [public Entando Hub](http://hubdev.okd-entando.org/entando-de-app/en/test.page#/) for installation in a user environment, where turnkey functionality can be customized and extended.
+Each Open Source Solution Template was built with Entando and can be used as-is, reviewed for common development practices, or considered a useful starting point for a related application. 


"or considered a useful starting point for a related application." >> take out considered

"considered" has to be replaced with another verb in order for it to make sense... going with "leveraged"

jyunmitch · 2022-01-26T23:07:40Z

vuepress/docs/v6.3.2/tutorials/samples/landing-page.md

+
+## Entando Standard Banking Demo
+
+The [Entando Standard Banking Demo](install-standard-demo.md) showcases modularity benefits and composability innovation as implemented by the Entando platform. Prominent features include RBAC Keycloak integration, coexistence of React and Angular MFEs, pluggable Spring Boot microservices, and sophisticated MFE communication techniques.


The writing is great here, straightforward and concise but for the features, can we mention some of the widgets listed in the details to exemplify what it can do?

we can definitely do that! i'm going to try to reword this a bit more attractively, focusing on clarity and benefits, but i'm a little worried about deviating from short descriptions. i was thinking this (and the pda blurb) made for enough bait to entice the appropriate audience, but we can try to find better language

nshaw

Minor thing, let's remove the 2 big standard demo images in favor of the minified version I sent you. That was my bad for sending you a 1MB file without thinking about it.
Maybe we can remove the TODOs and add them to the cleanup ticket? Alternatively, add an item to the cleanup ticket to make sure we look for all TODOs. :)

nshaw · 2022-01-27T14:21:34Z

vuepress/docs/v6.3.2/tutorials/samples/landing-page.md

+- [**Entando Process Driven Applications Plugin**](pda-tutorial.md)
+- [**Entando Standard Banking Demo**](install-standard-demo.md)
+
+Each Open Source Solution Template was built with Entando and can be used as-is, reviewed for common development practices, or leveraged as a useful starting point for a related application. 


Let's lowercase Open Source. Seems off somehow unless I missed a discussion on that.

nshaw · 2022-01-27T17:43:39Z

vuepress/docs/v6.3.2/tutorials/samples/landing-page.md

+
+## Entando Hub
+
+The [Entando Hub](hub.md) empowers a team to share and collaborate on proprietary or Entando Open Source components. Capabilities, versions and metadata can be transparently analyzed, managed and published.


open source

ENDOC-412 First pass at Solution Template page

085292b

Lyd1aCla1r3 requested review from nshaw and jyunmitch January 21, 2022 22:53

Lyd1aCla1r3 marked this pull request as draft January 21, 2022 22:53

Lydia added 3 commits January 21, 2022 14:59

ENDOC-412 Add placeholder to left nav

f9dcd6e

ENDOC-412 Version 1 before rework

bfb4ada

ENDOC-412 Version 2

e4ceee4

Lyd1aCla1r3 marked this pull request as ready for review January 24, 2022 21:50

jyunmitch reviewed Jan 25, 2022

View reviewed changes

nshaw requested changes Jan 25, 2022

View reviewed changes

Lydia added 2 commits January 25, 2022 17:08

ENDOC-412 Interim push

0439933

ENDOC-412 Missing nav structure

1db5bdc

jyunmitch reviewed Jan 26, 2022

View reviewed changes

Lydia added 2 commits January 26, 2022 17:11

ENDOC-412 Fine-tuning

c9a7b60

ENDOC-412 More fine-tuning

e5bb5d1

nshaw requested changes Jan 27, 2022

View reviewed changes

nshaw reviewed Jan 27, 2022

View reviewed changes

ENDOC-412 Final fixes

1751e92

nshaw approved these changes Jan 27, 2022

View reviewed changes

nshaw merged commit 68c1362 into main Jan 27, 2022

nshaw deleted the ENDOC-412 branch January 27, 2022 20:21

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

ENDOC-412 Create landing page for solution templates #395

ENDOC-412 Create landing page for solution templates #395

Lyd1aCla1r3 commented Jan 21, 2022

jyunmitch Jan 25, 2022 •

edited

Loading

nshaw Jan 25, 2022

jyunmitch Jan 25, 2022

nshaw Jan 25, 2022

jyunmitch Jan 25, 2022

jyunmitch Jan 25, 2022

jyunmitch Jan 25, 2022

Lyd1aCla1r3 Jan 26, 2022

jyunmitch Jan 25, 2022

Lyd1aCla1r3 Jan 26, 2022

jyunmitch Jan 25, 2022 •

edited

Loading

Lyd1aCla1r3 Jan 26, 2022

jyunmitch Jan 26, 2022

nshaw Jan 25, 2022

nshaw Jan 25, 2022

nshaw Jan 25, 2022

nshaw Jan 25, 2022

jyunmitch Jan 26, 2022

Lyd1aCla1r3 Jan 27, 2022

jyunmitch Jan 26, 2022

Lyd1aCla1r3 Jan 27, 2022

nshaw left a comment

nshaw Jan 27, 2022

nshaw Jan 27, 2022


		## Overview

		The Entando Application Composition Platform offers four Solution Templates to demonstrate various business capabilities and integrations. Each Solution Template provisions the building blocks and structure scoped for a particular implementation.


		The Entando Application Composition Platform offers four Solution Templates to demonstrate various business capabilities and integrations. Each Solution Template provisions the building blocks and structure scoped for a particular implementation.

		Solution Templates are available in the [public Entando Hub](http://hubdev.okd-entando.org/entando-de-app/en/test.page#/) for installation in a user environment, where turnkey functionality can be customized and extended.


		## Solution Template Details

		Specific features and use cases are highlighted below:


		Specific features and use cases are highlighted below:

		- Entando Customer Portal:\


		Solution Templates are available in the [public Entando Hub](http://hubdev.okd-entando.org/entando-de-app/en/test.page#/) for installation in a user environment, where turnkey functionality can be customized and extended.
		Each Open Source Solution Template was built with Entando and can be used as-is, reviewed for common development practices, or considered a useful starting point for a related application.


		## Entando Standard Banking Demo

		The [Entando Standard Banking Demo](install-standard-demo.md) showcases modularity benefits and composability innovation as implemented by the Entando platform. Prominent features include RBAC Keycloak integration, coexistence of React and Angular MFEs, pluggable Spring Boot microservices, and sophisticated MFE communication techniques.


		## Entando Hub

		The [Entando Hub](hub.md) empowers a team to share and collaborate on proprietary or Entando Open Source components. Capabilities, versions and metadata can be transparently analyzed, managed and published.

ENDOC-412 Create landing page for solution templates #395

ENDOC-412 Create landing page for solution templates #395

Conversation

Lyd1aCla1r3 commented Jan 21, 2022

jyunmitch Jan 25, 2022 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

jyunmitch Jan 25, 2022 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

nshaw left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

jyunmitch Jan 25, 2022 •

edited

Loading

jyunmitch Jan 25, 2022 •

edited

Loading