Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add into README.md info about target platform #294

Merged
merged 2 commits into from
Dec 27, 2023
Merged

Conversation

kudep
Copy link
Collaborator

@kudep kudep commented Dec 3, 2023

Description

Please describe here what changes are made and why.

Checklist

  • I have performed a self-review of the changes

List here tasks to do in order to complete this PR.

To Consider

  • Add tests (if functionality is changed)
  • Update API reference / tutorials / guides
  • Update CONTRIBUTING.md (if devel workflow is changed)
  • Update .ignore files, scripts (such as lint), distribution manifest (if files are added/deleted)
  • Search for references to changed entities in the codebase

@kudep kudep requested a review from RLKRo December 3, 2023 21:51
README.md Outdated
@@ -12,6 +12,8 @@ The Dialog Flow Framework (DFF) allows you to develop conversational services.
DFF offers a specialized domain-specific language (DSL) for quickly writing dialogs in pure Python. The service is created by defining a special dialog graph that determines the behavior of the dialog agent. The latter is then leveraged in the DFF pipeline.
You can use the framework in various services such as social networks, call centers, websites, personal assistants, etc.

DFF, a versatile Python-based conversational service framework, can be deployed across a spectrum of platforms, ensuring flexibility for both novice and seasoned developers. Cloud platforms like AWS, Azure, and GCP offer scalable environments for DFF, with options such as AWS Lambda and Azure Functions providing serverless execution. For containerized deployment, Docker and Kubernetes streamline the orchestration of DFF applications. Furthermore, the framework's adaptability extends to IoT ecosystems, making it suitable for integration with edge devices in scenarios like smart homes or industrial automation. Whether deployed on cloud platforms, containerized environments, or directly on IoT devices, DFF's accessibility and customization options make it a robust choice for developing conversational services in the evolving landscape of Python applications and IoT connectivity.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I feel like this has the same issue as Amazon Alexa. Maybe we shouldn't mention AWS, Azure without having anything to do with them (no user guides / tutorials, e.t.c.). I think that instead we could simply mention that DFF can be used on cloud platforms.

README.md Outdated
@@ -12,6 +12,8 @@ The Dialog Flow Framework (DFF) allows you to develop conversational services.
DFF offers a specialized domain-specific language (DSL) for quickly writing dialogs in pure Python. The service is created by defining a special dialog graph that determines the behavior of the dialog agent. The latter is then leveraged in the DFF pipeline.
You can use the framework in various services such as social networks, call centers, websites, personal assistants, etc.

DFF, a versatile Python-based conversational service framework, can be deployed across a spectrum of platforms, ensuring flexibility for both novice and seasoned developers. Cloud platforms like AWS, Azure, and GCP offer scalable environments for DFF, with options such as AWS Lambda and Azure Functions providing serverless execution. For containerized deployment, Docker and Kubernetes streamline the orchestration of DFF applications. Furthermore, the framework's adaptability extends to IoT ecosystems, making it suitable for integration with edge devices in scenarios like smart homes or industrial automation. Whether deployed on cloud platforms, containerized environments, or directly on IoT devices, DFF's accessibility and customization options make it a robust choice for developing conversational services in the evolving landscape of Python applications and IoT connectivity.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This feels like too much text (most of which is meaningless).
It was difficult for me to read that but I'm not sure if it's because of the amount of filler words or because it's late.

The essence of the text is rather short:

DFF can be deployed on various platforms:
- Cloud
- Containers
- IoT devices

If I was a user that was reading this I would give up after the first sentence and just skim the text looking for keywords such as Docker, AWS, IoT. We could save users some trouble by replacing this with a shorter version.

@RLKRo RLKRo merged commit 7652451 into dev Dec 27, 2023
17 checks passed
@RLKRo RLKRo deleted the doc/add_target_platforms branch December 27, 2023 17:41
RLKRo pushed a commit that referenced this pull request Dec 27, 2023
* Add into  README.md info about target platform

* restructure markdown

---------

Co-authored-by: Roman Zlobin <[email protected]>
(cherry picked from commit 7652451)
@RLKRo RLKRo mentioned this pull request Mar 1, 2024
1 task
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants