Wowchemy-hugo-modules: Add a teaching widget

[maxheld83]

Teaching has some interesting meta-data, too, and I wonder whether other people might find such a widget useful as well.
It might be quite similar to talks or publication, except with a different set of metadata:

• University (where the class took place)
• Kind: Section/Tutorial, Seminar, Lecture
• Academic Year / Quarter etc.
• Academic program the class is a part of

[gcushen]

This idea occurred to me a few times, thanks for thinking of a suitable data structure 😃

Quite a few lecturers I know tend to use their university's online lecture notes website platform, and then link to that from their personal site (which is possible via Academic's Custom or Projects widget), so I am not sure if many people want/need this feature...

If there is demand for it, I think it's definitely something we can consider implementing in Academic.

[HughP]

This would really be useful. If we are looking at data structure, and metadata, and or making the data we input "semantic", I have been following what the guys at schema.org have been doing on this recently: http://schema.org/Course

[gcushen]

I'm open to review pull requests for this...

[fernandomayer]

In my case, I edit my courses websites separately and only link them on my homepage. However, I want to keep a record of my past courses (links for the courses actually), with exactly that information (University, year/quarter, etc).

This way, a teaching widget could have a "Current teaching" session on the home page, but a link for "Past teaching", similar to the "publication" or "talks" widget.

That could be simpler actually. You can look what I did in my homepage under "Teaching". It's only a table, but I would like that "Past courses" could stay in another page (as that table will grow with time).

That would definitely be an enhancement IMHO.

[fabrizziosoares]

what does it means help wanted tag? Do you want one of us implement the solution? I can try a little bit, but I don't know Go but I can learn it.

[gcushen]

@fabrizziosoares help wanted means that I encourage users to contribute by progressing the design and implementation of this feature (I am not currently working on it). Note that Academic just uses TOML and the Go Templating language rather than the full Go language.

Feel free to clone/fork this repository, create a new branch for the feature (e.g. git checkout -b teaching-widget), add your changes and create a Pull Request on GitHub.

[fabrizziosoares]

Thanks @gcushen I'm gonna solve some personal stuff here and I'll be trying to do that.

[pjox]

Any progress on this? This widget would be very useful for me, I was planning on building something on top of the existing talks widget, but if there is any progress I'd be happy to collaborate.

[fabrizziosoares]

@pjox , for a while I am reusing project widget and putting people there, so I am doing same with teaching and adding courses on it.

[mathematicalmichael]

Hey @gcushen, is this still something worth taking on as a "first issue" and submitting a PR? I've already re-used the publications types once before, this seems like it'd be a really similar process. Alternatively, I could write up a README that describes all the steps necessary to "duplicate" a page type for those struggling with the templating language.

[HughP]

Two comments on this topic which I don't see on the thread. The first post outlines the following useful items as metadata:

• University (where the class took place)
• Kind: Section/Tutorial, Seminar, Lecture
• Academic Year / Quarter etc.
• Academic program the class is a part of

to this I suggest adding:

• Role of teaching :: including Lead/head teacher, instructor of record, co-instructor, Teaching Assistant. This is describable in schema.org as http://schema.org/educationalRole
• _Academic Year_ is different than a _date_ or a _date range_. So a date based duration would be useful.
• Course number :: from this, Americans often determine if the course was offered at a graduate or undergraduate level, this might not be the case for Australian or European based education systems. They may need a different bit of metadata for describing the learning level.
• Course Title
• Course description

[gcushen]

@mathematicalmichael first the requirements (such as data structure/metadata) need to be ironed out, so your feedback on that would be useful.

@HughP and others: how would you like to see a teaching feature implemented?

1. As just a widget which lists the courses that you teach
   
   
   
   • all of the course data would be defined in the front matter of a single teaching widget, similar to how the About widget, Experience widget, and Accomplishments widget list items based on the data specified in the _widget front matter_
   
   
   • each course can only be linked to an external course site or direct to an existing internal page such as course content that you have already created using the _docs/tutorial_ page type
   
   
2. As a widget (like above) but it would link each course to its own dedicated course page
   
   
   
   • each dedicated course page could show further details for the course and link to various internal or external course resources such as slides or course content that you have created using the _docs/tutorial_ page type
   
   

Also, what would you choose to name the widget (e.g. teaching) and the URL slug (e.g. YOU_SITE.com/teaching/course_title), if we were to give each course its own dedicated teaching page?

[HughP]

@gcushen
In my case I find that Widget Style 2 seems to be more usable. This also works for use cases where the teaching experience is not specifically a University course but might also be something like a workshop.

On my own CV (or see image below) I have a teaching section, but because I didn't have a way to model the courses I haven't really done anything more than what widget 1 would allow. I would hope that my teaching experience might describable with chea.org metadata using something like https://schema.org/Course or https://schema.org/hasCourseInstance .

I ran into the workshop issue when I was creating my wife's CV (which is not online but is included as an image below). I think that Workshops are more inline with https://schema.org/Event or https://schema.org/EducationEvent . This might be a reason to say that they are not teaching events — their metadata description is different.

I noticed a really creative presentation of teaching experience using this theme by @fliptanedo at https://theory.ucr.edu/flip/.

Hugh

Becky

Flip

[mathematicalmichael]

I think that teaching displays via projects like that is one way to display it. I also think that a summary can be sufficient and the use of the "docs" template would be suitable to give an overview of courses in the menu and content about them, which is kind of in line with style 2.

I am fairly confident I could handle this feature request if/when @gcushen decides on an architecture. I don't have any strong feelings on this since teaching isn't what I'm interested in highlighting, but I think it might be fit into a projects-like widget that leverages the filters. Here is two ways that might work:

Filter by class, each semester gets its own page in the template similar to "Publications", which has class info (meeting time, office hours) as metadata the way Publications currently formats it (see mathematicalmichael.com/artwork for an example of how I modified this template to do something similar).

Filter by semester, but each class still has its own page, though it can be one page for the class for which office hours and such are updated over time, not one page per class per semester as in the previous proposal.

(perhaps nothing is shown until a class is clicked on to save space). For people who have been teaching even a few years, i can imagine an exhaustive list becoming very cumbersome. I think brevity is preferable with one-page designs like CVs.

[HughP]

@mathematicalmichael that is a stand up design job keeping the front page short and using iconization to point other pages with specific sections. Well done. https://www.michaelpilosov.com. That said, in linguistics, a CV leans more towards comprehensive, rather than to a short summary which is what linguistic scholars call a resume. Naturally this is a design challenge when it comes to an interactive CV. I work with IT project implementation for linguistic data science project so I get to work with a few guys on visual design stuff. You hit an interesting sweet spot with your layout. The section layout for your "language section" makes lots of visual sense. Well done.

[mathematicalmichael]

thanks! still a work in progress after I ported to the new Academic version and update Hugo. Apologies if any links don’t work quite as expected yet, it’s on my radar for this week (among much else).

Moreover, thanks to you for making such an excellent theme. Lots of Hugo themes kind of fell off with active development, I’m thrilled to see that this project is so alive and well. At this point I’m familiar enough with it that I can begin to contribute PRs in some meaningful way.

MP

On Jan 13, 2019, at 11:46 PM, HughP [e-mail] wrote:

@mathematicalmichael https://github.com/mathematicalmichael that is a stand up design job keeping the front page short and using iconization to point other pages with specific sections. Well done. https://www.michaelpilosov.com https://www.michaelpilosov.com/.

—
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub https://github.com/gcushen/hugo-academic/issues/109#issuecomment-453913597, or mute the thread https://github.com/notifications/unsubscribe-auth/Amfwt-a_62mmfI9QIp5d6Oq1fprTpVtcks5vDCfigaJpZM4LwMhP.

[HughP]

@mathematicalmichael If you are going to do the structure work and want some exemplar data for your design work, I can make the teaching section of Becky's CV available. — that is if you would find having a small data set helpful to the design process.

[mathematicalmichael]

that would be great! tag anyone else in this thread who might be able to provide input on design?
MP

On Jan 14, 2019, at 12:12 AM, HughP [e-mail] wrote:

@mathematicalmichael https://github.com/mathematicalmichael If you are going to do the structure work and want some exemplar data for your design work, I can make the teaching section of Becky's CV available. — that is if you would find having a small data set helpful to the design process.

—
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub https://github.com/gcushen/hugo-academic/issues/109#issuecomment-453916990, or mute the thread https://github.com/notifications/unsubscribe-auth/Amfwt8VRPZ5XMCZ2IuyRp1hPfRlgWHONks5vDC3vgaJpZM4LwMhP.

[HughP]

@mathematicalmichael here is the gist for teaching: https://gist.github.com/HughP/d8d9b3477f0c2ea5ed1f3c43c719f422

and here is the gist for workshops: https://gist.github.com/HughP/c0a2895cdeff863fbb68f174334a43ff

[stale[bot]]

This issue has been automatically marked as stale because it has not had any recent activity. The resources of the Academic team are limited, and so we are asking for your help.
If this is a bug and you can still reproduce this error on the master branch, please reply with all of the information you have about it in order to keep the issue open.
If this is a feature request, and you feel that it is still relevant and valuable, please tell us why.
This issue will automatically close soon if no further activity occurs. Thank you for your contributions.

[mathematicalmichael]

sorry I haven't been able to get to this! truth is I haven't been able to keep up with the frequent updates to the theme and have fallen several versions behind. Considering starting a new and porting content over somewhat manually... =/