openedx / training-courses

Repo for course content & Issues related to Open edX training courses
Other
4 stars 1 forks source link

Product Overview Subsection #8

Closed jalondonot closed 1 year ago

jalondonot commented 1 year ago

Milestone: The Open edX Project

Description Creating the content for the "Platform overview" subsection.

Sub-tasks

Definition of Done The initial version of the "Platform overview" subsection is published.

mariajgrimaldi commented 1 year ago

assign me

mariajgrimaldi commented 1 year ago

Currently working on "Tech Stack" unit while I wait for answers for the "About the Open edX project" form.

sarina commented 1 year ago

Hi! I changed the title of this to Product Overview.

Can you please move the last unit to module 3?

I added a first unit called "Defining Product" and rewrote the product offerings section to be more accessible. I wrote the OEP-57 so probably easier for me to figure out how to summarize this. I also added a third unit to present the OEP-57 diagram (a bit simplified) and explain more in depth. Can you please review these? Is the third unit too complicated?

I was thinking of adding a fourth section about the Product Working Group and how to get involved if this interests you. How does that sound?

Finally, what images or other stuff could we add to make this more interesting?

mariajgrimaldi commented 1 year ago

Hello! I moved the architecture unit to module 3! Thanks for the reminder.

Can you please review these? Is the third unit too complicated?

This is great content! Just a short note on the last unit, so it is more beginner-friendly:

behind the scenes code that lets you use extensions like XBlocks and LTI

Could we add links for Xblocks and LTI docs? I feel that a newcomer wouldn't know what these extensions are. Same comment for the bundled extensions.

I was thinking of adding a fourth section about the Product Working Group and how to get involved if this interests you. How does that sound?

There's a section in the Community module where we include a list of all the wg with relevant info, do you think we could add that there? Or is it better right there on the product overview?

sarina commented 1 year ago

Could we add links for Xblocks and LTI docs? I feel that a newcomer wouldn't know what these extensions are. Same comment for the bundled extensions.

That's a great idea!

There's a section in the Community module where we include a list of all the wg with relevant info, do you think we could add that there? Or is it better right there on the product overview?

Hmmm.... I'm not sure. How about a fourth section that says "We have a working group yay! If you're interested in this you should come to a meeting. See the Working Groups section of this course for more info" (with a link to the WG section)

mariajgrimaldi commented 1 year ago

@sarina I like the idea of a 4th section! 🥇

sarina commented 1 year ago

Great! I'm going to leave this ticket open until we write the Working Groups unit, so that I remember to link to it from this section.