Videos → Learn | Documentation ?

[Chris00]

I am wondering whether the videos qualify as documentation or would be better in the section "Learn".

Given that the FAQ will (temporarily?) disappear, the column " Common Questions" could be used for the videos (and be advertised on the front page — I think this is nice for newcomers but less interesting as documentation (not searchable, difficult to skim through),

[avsm]

Categorizing some of these videos might make sense -- there's a large spectrum (from the CUFP/ICFP/OCaml Workshop proceedings) of tutorials, experiences and research talks.

On 11 Nov 2013, at 12:23, Christophe Troestler notifications@github.com wrote:

I am wondering whether the videos qualify as documentation or would be better in the section "Learn".

Given that the FAQ will (temporarily?) disappear, the column " Common Questions" could be used for the videos (and be advertised on the front page — I think this is nice for newcomers but less interesting as documentation (not searchable, difficult to skim through),

— Reply to this email directly or view it on GitHub.

[agarwal]

It's like the FAQ page in the sense that both were wishes that never materialized. The motivation for the videos page was just that some people like videos, so we thought we can have a stream of them on a single page. The problem is we only got 3 links, and even if we improve the page right now, it'll get out of date again. Ideally, videos would be linked from some other section that they are appropriate to, and then this page would automatically be a stream of all of them. Not sure how to implement that.

[Chris00]

On Mon, 11 Nov 2013 12:33:58 -0800, Ashish Agarwal wrote:

It's like the FAQ page in the sense that both were wishes that never materialized.

A FAQ page is good but could be advertised in the "Tutorials" section (the title should then be slightly changed).

The motivation for the videos page was just that some people like videos, so we thought we can have a stream of them on a single page.

The Learn page is supposedly the first one people — curious about the language — are directed to, so some videos may be nice alongside "Industrial Users" and "Success stories".

The problem is we only got 3 links, and even if we improve the page right now, it'll get out of date again. Ideally, videos would be linked from some other section that they are appropriate to, and then this page would automatically be a stream of all of them. Not sure how to implement that.

I guess one has to define a special HTML container (video frame + description) and then scan the site and collect those. One may want to proceed the other way around: have the videos on the page (with a label) where a description (and classification) is required and call them (via the label, with or without the description) where they are needed.

Let us have more videos first.

[Chris00]

I have created a new branch videos with a proposal of modification of the "Learn" page. Please let me know what you think.

[amirmc]

I think this works much better. I'd like to have the slides embedded such that I can click through them right on the page (instead of opening a PDF). I've made an account on speakerdeck and put the slides there [1], so we could embed that presentation. We could set up an account on Slideshare if that's preferred (I only used speakerdeck as I prefer the UI).

NB: I still think we should keep original docs safely archived somewhere but the user experience is much improved using mechanisms like the above.

https://speakerdeck.com/ocaml/the-state-of-ocaml-2013

[amirmc]

I'm also wondering how we automate as much as possible for features like the above. What if we set up a feed of 'media' for OCaml things? We can add any slides and videos to it (with captions) and they'd find their way into a widget on this page as well as a 'media' page elsewhere. Perhaps I'm over-thinking this but it would help to keep content fresh with minimal effort.

This would function somewhat like planet but would require some central control to manually add content as it becomes available. Thoughts?

[agarwal]

IMO, we should do this:

• Keep a copy of all media ourselves, e.g. in the ocaml.org-media repo.
• In the ocaml.org repo, keep metadata about the videos such as: the file path in the ocaml.org-media repo, the link to YouTube, slideshare, speakerdeck, etc., and maybe a caption.

Then, we can have code that generates content as we want.

[Chris00]

I have embedded speakerdeck interface. 91caad903675b32b79a3950433eb41218a0ca77d I'll copy the changes to the main repo when we are happy with them.

[Chris00]

Merged the changes a55d70e8792b753b968897c19a4de51fe3236705

[amirmc]

I'm going to move the actual videos.md file to community/media.md (ie. change the name too). I'll add/update the links on the docs and learn page.

[amirmc]

Done but I'm leaving this issue open for the moment as a reminder (need to create other issues based on the discussion here)

[Chris00]

@amirmc Just a gentle reminder! :-)

[ghost]

Note: Can use a tag on tech focused peertube instance(s) such as https://scitech.video/search?tagsOneOf=python , to actually house videos