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

Update Personas Page #54

Open
wants to merge 6 commits into
base: pre-draft
Choose a base branch
from
Open

Conversation

jjaswanson4
Copy link

Description

This PR updates and clarifies the persona page

Issues Addressed

This PR intends to accomplish a few objectives:

  • Allow for "grouping" of personas into a categories
  • Add some new personas
  • Update persona names for clarity
  • Add a visualization to describe relationships

Change Type

Please select the relevant options:

  • Fix (change that resolves an issue)
  • New enhancement (change that adds specification content)
  • Content edits (change that edits existing content)

Checklist

  • I have read the CONTRIBUTING document.
  • My changes adhere to the established patterns, and best practices.

@jjaswanson4 jjaswanson4 requested a review from a team as a code owner December 11, 2024 16:39
Copy link

linux-foundation-easycla bot commented Dec 11, 2024

CLA Not Signed

@jjaswanson4
Copy link
Author

Requesting review from @ajcraig and @mirthguitar to start

Copy link
Contributor

Choose a reason for hiding this comment

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

Diagram is a good addition but for me, it's too small and hard to read.

Copy link
Contributor

Choose a reason for hiding this comment

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

The diagram has an "Architecture Blueprint" area. What is meant by this and why does this have IT support?

Copy link
Contributor

Choose a reason for hiding this comment

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

I understand that the End User Architect can create blueprints like:

  • Stack for device A supporting the docker-compose deployment.
  • Stack for device A supporting the helm deployment.
  • Stack for device B supporting the docker-compose deployment.

What I don't understand is the role of the IT Service Provider on the blueprints. On deployment makes sense, though.

Choose a reason for hiding this comment

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

I think the intent of the the "IT Service Provider" is that IT can provide certain functions the OT system might need... internet access, user authentication, perhaps storage etc...

The goal of the End User architect is an umbrella term for system integrator and plant personnel responsible for deciding what is used where, and how they'll use it, etc...

Copy link
Author

Choose a reason for hiding this comment

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

Should the "IT Service Provider" persona be updated for clarity?

system-design/margo-overview/personas.md Show resolved Hide resolved
system-design/margo-overview/personas.md Show resolved Hide resolved

#### Workload Supplier

Provides an application that performs some desired function, such as computer vision, software-defined control, etc, which is deployed to devices by an orchestrator
Copy link
Contributor

Choose a reason for hiding this comment

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

I was in the "orchestrator" discussion, this comment is somehow a follow-up.

What do you mean with "orchestrator" in this case? What such an orchestrator coordinates?

Copy link
Author

Choose a reason for hiding this comment

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

Yea I need to update this to a new definition, will add a commit


#### Orchestrator Supplier

Provides a software package that ingests application definitions into a catalog, and allows an end user to deploy that application to devices
Copy link
Contributor

Choose a reason for hiding this comment

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

This does not sound to me like an orchestrator. It sounds to me more like a "publisher".

system-design/margo-overview/personas.md Show resolved Hide resolved
Copy link
Contributor

Choose a reason for hiding this comment

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

I understand that the End User Architect can create blueprints like:

  • Stack for device A supporting the docker-compose deployment.
  • Stack for device A supporting the helm deployment.
  • Stack for device B supporting the docker-compose deployment.

What I don't understand is the role of the IT Service Provider on the blueprints. On deployment makes sense, though.

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.

5 participants