OpenEnergyPlatform / academy

The Open Energy Academy is a collection of courses, tutorials, and questions for the Open Energy Family
https://openenergyplatform.github.io/academy/
GNU Affero General Public License v3.0
16 stars 6 forks source link

Confusing List of Tutorials shown on OEP #119

Closed christian-rli closed 2 years ago

christian-rli commented 3 years ago

Currently it seems like only tutorials from this directory are linked on the OEP tutorials page. There are several issues with that. The naming often isn't ideal and the name is the only indicator for the content. There should be a descriptive name for all available tutorials.

Originally an overview table was planned that also categorizes tutorials into video / text / jupyter. Is this still under development @johannwagner or has it dropped off the list of things that were worked on at some point? In future there should probably be a short description visible for every tutorial, visible before going there, too.

jh-RLI commented 3 years ago

I think this is already worked on in https://github.com/OpenEnergyPlatform/oeplatform/pull/630 . At least the tutorial naming. @TuPhanRLI If you have time atm could you try to run this branch on your machine? Then we can decide if this will solve part of the Issue or not.

jh-RLI commented 3 years ago

How the Tutorial name is set on the OEP:

The name of a tutorial displayed in the list on the OEP is taken from the 1st heading in the respective jupyter notebook.

Edit: I noticed there is another constraint to the title selection. If the first heading is "Open Energy Platform" then it is skipped and the second heading is selected.

christian-rli commented 3 years ago

This will be fixed with the new naming scheme that uses a json file to define the tutorials to be listed on the OEP. @jh-RLI introduced the new naming scheme in https://github.com/OpenEnergyPlatform/tutorial/pull/127 . If all goes well, only well named and relevant tutorials show up after the new release.