Arbital "teaches" relationship

It would be silly to have a sys­tem that de­mands users to know things with­out also pro­vid­ing a way to teach them. This is why the pages can also teach req­ui­sites. A page can teach many req­ui­sites, and there can be many pages teach­ing the same req­ui­site, each one tai­lored to a spe­cific au­di­ence or learn­ing style. For ex­am­ple, “JavaScript for be­gin­ners” and “From Java to JavaScript” pages could both teach “JavaScript func­tions” req­ui­site among oth­ers.

When to add a “teaches” relationship

When a page has been writ­ten speci­fi­cally to ex­plain the con­cept. For ex­am­ple:

  • This page has been writ­ten speci­fi­cally to ex­plain the con­cept of “teaches” re­la­tion­ships.

  • Bayes’ rule: Func­tional form is writ­ten speci­fi­cally to ex­plain that con­cept.

If the page pro­vides links to ma­te­ri­als that teach the req­ui­sites. (In that case, make sure “This page teaches its req­ui­sites in­di­rectly” set­ting is on.) For ex­am­ple:

A page can teach it­self. In fact, this hap­pens pretty fre­quently, since the page it­self is most nat­u­ral place for the user to look when they want to learn the topic.

When not to add a “teaches” relationship

  • If the page talks about some con­cept, but doesn’t go in enough depth to fully ex­plain it. For ex­am­ple, if the user is read­ing a page about “Bit­coin”, it’s quite likely the page will talk about the blockchain, but it’s un­likely it’ll re­ally ex­plain that con­cept to the reader.

Some­times it can be un­clear if the pages should have a “teaches” re­la­tion­ship. If you run into a case you can’t clearly re­solve, please post it here, so we can dis­cuss it, learn from it, and re­fine these defi­ni­tions.