The one markup language to rule them all?
Documentation at: docs.ourbigbook.com.
Base JavaScript library that implements the OurBigBook Markup. Use by both:
The website system that runs OurBigBook.com. For further information see:Relies on the OurBigBook Library to compile OurBigBook Markup.
The website is the reference instance of OurBigBook Web, which is part of the OurBigBook Project, the other main part of the project are software that users can run locally to publish their content such as the OurBigBook CLI.
The source code for ourbigbook.com is present at: github.com/ourbigbook/ourbigbook/tree/master/web
The project documentation is present at: docs.ourbigbook.com#ourbigbook-web-user-manual
This page contains further information about the project's rationale, motivation and planning.
Figure 1.
The topics feature allows you to find the best version of a subject written by other users user
. Live demo: derivative.
These are websites that offer somewhat overlapping services, many of which served inspirations, and why we think something different is needed to achieve our goals.
Notably, OurBigBook is the result of Ciro Santilli's experiences with:
OurBigBook could be seen as a cross between those three websites.
Quick mentions:
Static website-only alternatives:
Conceptual:
  • you don't get any/sufficient recognition for your contributions. The closest they have to upvotes and reputation is the incredibly obscure "thank" feature which is only visible to the receiver itself: en.wikipedia.org/wiki/Help:Notifications/Thanks
  • deletionism is a tremendous problem on Wikipedia, for two main causes:
    • tutorial-like subjectivity
    • notability
    The stuff you wrote can be deleted anytime by some random admin/opposing editor, examples at: Section "Deletionism on Wikipedia".
    This also possibly leads to Edit wars in the case of sub-page content (full page deletion is more clearly arbitrated).
  • Scope too limited, and politics defined. Everything has to sound encyclopedic and be notable enough. This basically excludes completely good tutorials.
  • Insane impossible to use markup language-base talk pages instead of issue trackers?! Ridiculous!!! That change alone could make Wikipedia so much more amazing. Wikipedia could become a Stack Exchange killer by doing that alone + some basic reputation system. Some work on that is being done at: www.mediawiki.org/wiki/Extension:DiscussionTools, already in Beta as of 2022.
  • Edit wars
Stack Exchange solves to a good extent the use cases:
  • I have a very specific question, type it on Google, find top answers
  • I have an answer, and I put it here because it has a much greater chance of being found due to the larger PageRank than my personal web page will ever have
points of view. It is a big open question if we can actually substantially improve it.
Major shortcoming are mentioned at idiotic Stack Overflow policies:
Basically everything that applies to the blogs section also applies here, but university lecture notes are so important to us that they deserve a bit more talk.
It is arguable that this is currently the best way to learn any university subject, and that it can already be used to learn any subject.
We basically just want to make the process more efficient and enjoyable, by making it easier:
  • to find what you want based on an initial subject hit across the best version of any author
  • and to publish your own stuff with one click, and get feedback if people like it or not, and improvement suggestions like you do you GitHub
One major problem with lecture notes is that, as the name suggests, they are merely a complement to the lecture, and don't contain enough detail for you to really learn solely from them without watching the lecture.
The only texts that generally teach in enough depth are actual books, which are almost always commercial.
So in a sense, this project can be seen as a path to upgrade free lecture notes into full blown free books, from which you can learn from scratch without any external material.
And a major way in which we believe this can be done is through the reuse of sections of lecture notes by from other universities, which greatly reduces the useless effort of writing things from scratch.
The intended mental picture is clear: the topics feature docs.ourbigbook.com/#ourbigbook-web-topics will is intended to act as the missing horizontal topic integration across lecture notes of specific universities, e.g:
MIT calculus course             UCLA calculus course

* Calculus                <---> * Calculus
  * Limit                 <--->   * Limit
    * Limit of a function
    * Limit of a series   <--->     * Limit of a series
  * Derivative            <--->   * Derivative
                                    * L'Hôpital's rule
  * Integral              <--->   * Integral
Figure 1.
Example topics page of OurBigBook.com
.
One important advantage of lecture notes is that since they are written by the teacher, they should match exactly what "students are supposed to learn to get good grades", which unfortunately is a major motivation for student's learning weather we want it or not.
One big open question for this project is to what extent notes written for lectures at one university will be relevant to the lectures at another university?
Is it possible to write notes in a way that they are naturally reusable?
It is our gut feeling that this is possible. But it almost certainly requires an small intentional effort on the part of authors.
The question then becomes whether the "become famous by getting your content viewed in other universities" factor is strong enough to attract users.
And we believe that it might, it just might be.
A major difficulty of getting such this to work is that may university teachers want to retain closed copyright of their work because they:
Therefore the only way is to find teachers who are:
  • enlightened to use such licenses
  • forced by their organizations to use such licenses
The forced option therefore seems like a more bulk efficient starting point for searches.
No matter how much effort a single person puts into writing perfect tutorials, they will never beat 1000x people + an algorithm.
It is not simply a matter of how much time you have. The fundamental reason is that each person has a different background and different skills. Notably the young students have radically different understanding than that of the experienced teacher.
Therefore, those that refuse to contribute to such platforms, or at least license their content with open licenses, will inevitably have their work forgotten in favor of those that have contributed to the more open platform, which will eventually dominate everything.
Perhaps OurBigBook.com is not he killer platform that will make this happen. Perhaps the world is not yet ready for it. But Ciro believes that this will happen, sooner or later, inevitable, and he wants to give it a shot.
Also worth checking:
Figure 1. Source. Convincing academics that their tutorial are not always perfect is one of blocking points to the acceptance of solutions such as OurBigBook.com. To thrive in the competition of academia, those people are amazing at publishing novel results. Explaining to beginners however, not necessarily so.
Some possible/not possible sources that could be used to manually bootstrap content:
Lecture note upload website:
Exams uploads:
A list of reviews of such systems is maintained at:
This is the class of existing software the perhaps comes the closest to OurBigBook, in particular systems such as:
While we believe that OurBigBook can hold its own against most of them as a personal knowledge base, there is one feature which we believe truly distinguishes OurBigBook from all others in a big way: trustless mind meld with the OurBigBook topic feature, which no other system seems to have.
Many such systems are also no publishing focused enough, and are more focused only in maintaining people's private knowledge bases. Some of them don't even have publishing at all, or its complicated. While publishing is optional in OurBigBook, it is a crucial feature and extremely well supported.
This website basically aims to be a learning management system, allowing in particular a teacher to focus his help on students that he is legally obliged to help due to their job. But it will have the following unusual characteristics in current LMS solutions:
  • public first, to allow reuse across universities, rather than paywalled as is the case for most top universities
  • students can create material just like teachers, both are on equal footing. Students/teachers will see an indicator "this is your teacher"/"this is your student for this/past semester", but that is the only difference between their interfaces.
If Ciro Santilli were to write a book about quantum mechanics as of 2020 (before OurBigBook.com went live), he would upload an OurBigBook Markup website to GitHub Pages.
But there is one major problem with that: the entry barrier for new contributors is very large.
If they submit a pull request, Ciro has to review it, otherwise, no one will ever see it.
Our amazing website would allow the reader to add his own example of, say, The uncertainty principle, whenever they wants, under the appropriate section.
Then, people who want to learn more about it, would click on the "defined tag" by the article, and our amazing analytics would point them to the best such articles.
  • HyperCard: we are kind of a "multiuser" version of HyperCard, trying to tie up cards made by different users. It is worth noting that HyperCard was one of the inspirations for WikiWikiWeb, which then inspired Wikipedia
  • Semantic Web
  • NLab
  • physicstravelguide.com/ Nice manifesto: physicstravelguide.com/about by Jakob Schwichtenberg.
  • OpenStax
  • www.ft.com/content/5515ec3e-0040-4d90-85a9-df19d6e3ebd2 (archive) Twilio’s Jeff Lawson: an evangelist for software developers
    As a student at the University of Michigan, he started a company that made lecture notes available free online, drawing a large audience of Midwestern college students and, soon enough, advertisers. At the height of the dotcom bubble, he dropped out of college, raised $10m from the venture firm Venrock and moved the company to Silicon Valley.
    His start-up drew interest from an acquirer that was planning to go public early in 2000. They closed the acquisition but missed their IPO window as the market plunged, and by August the company had filed for bankruptcy. Stock that Lawson and investors in his start-up received from the sale became worthless.
    You can never be first. But you can have the correct business model. That company's website must have gone into IP Purgatory, and could never be released as an open source website.
    This project won't make a lot of money. Open source and not-for-profit seems like the way to go.
    The website was called stubhub.com/, as of 2021 the domain had been sold to an unrelated website.
    He might actually be interested in donating to OurBigBook.com if it move forward now that he's a billionaire.
  • Knol: basically the exact same thing by Google but 14 years earlier and declared a failure. Quite ominous:
    Any contributor could create and own new Knol articles, and there could be multiple articles on the same topic with each written by a different author.
  • leanpub: similar goals, markdown-based, but the usual "you own your book copyright and you are trying to sell your book" approach
  • nature Scitable
Many subjects have changed very little in the last hundred years, and so it is mind-blowing that people have to pay for books that teach them!
If computers are bicycles for the mind, Ciro wants this website to be the Ferrari of the mind.
Since Ciro Santilli was young, he has been bewildered by the natural sciences and mathematics due to his bad memory.
The beauty of those subjects has always felt like intense sunlight in a fresh morning to Ciro. Sometimes it gets covered by clouds and obscured by less important things, but it always comes back again and again, weaker or stronger with its warmth, guiding Ciro's life path.
As a result, he has always suffered a lot at school: his grades were good, but he wasn't really learning those beautiful things that he wanted to learn!
School, instead of helping him, was just wasting his time with superficial knowledge.
First, before university, school organization had only one goal: put you into the best universities, to make a poster out of you and get publicity, so that more parents will be willing to pay them money to put their kids into good university.
Ciro once asked a chemistry teacher some "deeper question" after course was over, related to the superficial vision of the topic they were learning to get grades in university entry exams. The teacher replied something like:
You remind me of a friend of mine. He always wanted to understand the deeper reason for things. He now works at NASA.
Ciro feels that this was one of the greatest compliments he has ever received in his life. This teacher, understood him. Funny how some things stick, while all the rest fades.
Another interesting anecdote is how Ciro Santilli's mother recalls that she always found out about exams in the same way: when the phone started ringing as Ciro's friends started asking for help with the subjects just before the exam. Sometimes it was already too hopelessly late, but Ciro almost always tried. Nothing shows how much better you are than someone than teaching them.
Then, after entering university, although things got way better because were are able to learn things that are borderline useful.
Ciro still felt a strong emotion of nostalgia when after university his mother asked if she could throw away his high school books, and Ciro started tearing them all down for recycling. Such is life.
University teachers were still to a large extent researchers who didn't want to, know how to and above all have enough time and institutional freedom to teach things properly and make you see their beauty, some good relate articles:
The very fact that you had very little choice of what to learn so that a large group can get a "Diploma", makes it impossible for people to deeply learn what the really want.
This is especially true because Ciro was in Brazil, a third world country, where the opportunities are comparatively extremely limited to the first world.
Also extremely frustrating is how you might have to wait for years to get to the subject you really want. For example, on a physics course, quantum mechanics is normally only taught on the third year! While there is value to knowing the pre-requisites, holding people back for years is just too sad, and Ciro much prefers backward design. And just like the university entry exams, this creates an entry barrier situation where you might in the end find that "hey, that's not what I wanted to learn after all", see also: students must have a flexible choice of what to learn.
We've created a system where people just wait, and wait, and wait, never really doing what they really want. They wait through school to get into university. They wait through university to get to masters. They wait through masters to get to PhD. They wait through PhD to become a PI. And for the minuscule fraction of those that make it, they become fund proposal writers. And if you make any wrong choice along the, it's all over, you can't continue anymore, the cost would be too great. So you just become software engineer or a consultant. Is this the society that we really want?
And all of this is considering that he was very lucky to not be in a poor family, and was already in some of the best educational institutions locally available already, and had comparatively awesome teachers, without which he wouldn't be where he is today if he hadn't had such advantages in the first place.
But no matter how awesome one teacher is, no single person can overcome a system so large and broken. Without technological innovation that is.
The key problem all along the way is the Society's/Government's belief that everyone has to learn the same things, and that grades in exams mean anything.
Ciro believes however, that exams are useless, and that there are only two meaningful metrics:
  • how much money you make
  • fame for doing for doing useful work for society without earning money, which notably includes creating new or better free knowledge such as in academic papers, either novel or review
Even if you wanted to really learn natural sciences and had the time available, it is just too hard to find good resources to properly learn it. Even attending university courses are hit and miss between amazing and mediocre teachers.
If you go into a large book shop, the science section is tiny, and useless popular science books dominate it without precise experiment descriptions. And then, the only few "serious" books are a huge list of formulas without any experimental motivation.
And if you are lucky to have access to an university library that has open doors, most books are likely to be old and boring as well. Googling for PDFs from university courses is the best bet.
Around 2012 however, he finally saw the light, and started his path to Ciro Santilli's Open Source Enlightenment. University was not needed anymore. He could learn whatever he wanted. A vision was born.
To make things worse, for a long time he was tired of seeing poor people begging on the streets every day and not doing anything about it. He thought:
He who teaches one thousand, saves one million.
which like everything else is likely derived subconsciously from something else, here Schindler's list possibly adapted quote from the Talmud:
He who saves the life of one man saves the entire world.
So, by the time he left University, instead of pursuing a PhD in theoretical Mathematics or Physics just for the beauty of it as he had once considered, he had new plans.
We needed a new educational system. One that would allow people to fulfill their potential and desires, and truly improve society as a result, both in rich and poor countries.
And he found out that programming and applied mathematics could also be fun, so he might as well have some fun while doing this! ;-)
So he started Booktree in 2014, a GitLab fork, worked on it for an year, noticed the approach was dumb, and a few years later started building this new version. The repo github.com/booktree/booktree is a small snapshot of Ciro's 2014 brain on the area, there were quite a few similar projects at the time, and most have died.
Ciro is basically a librarian at heart, and wants to be the next:
Video 1.
"Jimmy Wales: How a ragtag band created Wikipedia" 2005 TED talk
. Source. Original source: www.ted.com/talks/jimmy_wales_the_birth_of_wikipedia.
Video 2.
"Brewster Kahle: A digital library, free to the world." 2007 TED Talk
. Source. Talks about the Internet Archive which he created.
Video 3.
Sal Khan from Khan Academy 2016 TED talk
. Source. Ciro is not a big fan of the "basis on top of basis focus" because of his obsession with backward design, but "learn to mastery at your own pace" and "everyone can be a world class innovator" are obviously good.
Education has become an expensive bureaucratic exercise, completely dissociated from reality and usefulness.
It completely rejects what the individual wants to achieve, and instead attempts to mass homogenize and test people through endless hours of boredom.
And the only goals it achieves are testing student's resilience to stress, and facilitating the finding of sexual partners. True learning is completely absent.
Teachers only teach because they have to do it to get paid, not for passion. Their only true incentive is co-authoring papers.
We reject this bullshit.
Education is meant to help us, the students, achieve our goals through passionate learning.
And, we, the students, are individuals, with different goals and capabilities.
The way we protest is to publish the knowledge from University for free, on the Internet, so that anyone can access it.
And we do this is a law-abiding way, without copyright infringement, so that no one can legally take it down.
We come to our courses just for the useless roll calls. But we already know all the subject better than the "teacher" on the very first day.
And we are already more famous than the "teacher" online, and through the Internet have already taught more way way more people than they ever will.
The effect of this is to demoralize the entire school system at all levels, until only one conclusion is possible: implosion.
And from the ashes of the old system, we will build a new one, which does only what matters with absolute efficiency: help the individual students achieve their goals.
A system in which the only reason why university exist will be to allow the most knowledgeable students to access million dollar laboratory equipment, and to pay the most prolific content creators so they can continue content creating.
No more useless courses. No more useless tests. Only passion, usefulness and focus.
It would be really cool to have a PageRank-link algorithm that answers the key questions:
However, Ciro has decided to leave this for phase two action plan, because it is impossible to tune such an algorithm if you have no users or test data.
Perhaps it is also worth looking into ExpertRank, they appear to do some kind of "expert in this area", but with clustering (unlike us, where the clustering would be more explicit).
Other dump of things worth looking into:
The general and ideal user acquisition is of course organic Googling:
  • user does not understand his teacher's explanation of a subject
  • user Googles into rare specific subject
  • looks around, then login/create account with OAuth to leaves a comment or upvote
  • notice that you can fork anything
  • mind = KABOOM
However, before that point, it is very likely that Ciro will have to physically do some very hard and specific user acquisition work at some University. Maybe there is a more virtual way of achieving this.
This work will involve going through some open set of university lecture notes, and creating a superior version of them on OurBigBook.com, and somehow getting students to notice it and use it as a superior alternative to their crappy lecture notes.
Another very promising route is publishing the answers to old examination questions on the website. It is likely that we will be able to overcome any copyright issues by uploading only the answers to numbered questions. There is a minor risk that these would be considered derivative works of the copyrighted questions. But universities would have to be very anal to enforce a DMCA for that!!!
Getting in contact with students is an epic challenge, as an incredibly deep chasm separates us:
  • it is basically impossible to try and approach teachers: how to convince teachers to use CC BY-SA
  • and on the other hand, how will you get university students to trust you are not a pedophile and that you actually want to help them?
    The missing aspect is how to join their main "class communication group", e.g. a WhatsApp or Discord chat they have. That would be the perfect entry point to communicate with the end users. But that entry point is also generally closed exclusively for students, and sometimes lecturers, and will not accept anyone external.
    Perhaps Ciro would be able to do something with one of the two Universities he attended in the past: École Polytechnique or University of São Paulo. But there was no clear channel in those institutions for that. There is either an "infinitely noisy Facebook with everyone that bothered" or silence, deathly silence and isolation of no contact. The key hard part is getting a per-course granularity chat. Discord Student Hubs are a fantastic initiative in that area. Shame that Discord is an unusable mess with zero ways to select which notifications you care about: Section "Discord email notifications"!
    One approach method that shows some promise is to follow the Student societies, which often host open events of interest outside of work hours.
Walking with advertisement t-shirts mentioning specific course names in some university location is something Ciro seriously considers, that's how desperate things are. Watch out: docs.ourbigbook.com/#public-relations for T-shirt news!
There is basically only one scalable business model in education as of the 2020's: helping teenagers pass university entry exams. And nothing else. Everything else is a "waste" of time.
Perhaps there is a little bit of publicity incentive to helping them win knowledge olympiads as well, but it is tiny in comparison, and almost certainly not a scalable investment. This may also depend on whether universities consider anything but exams, which varies by country.
That marked is completely saturated, and Ciro Santilli refuses to participate in it for moral reasons.
Beyond that, there is no scalable investment. Other non-scalable investments that could allow one to make a lifestyle business are:
  • extra-curricular initiatives to get younger children interested in science. These may have some money stream coming from the parents of the children. This happens because for young children, the parents are more in control, and the parents, unlike the students, have some money to spend. An example: www.littlehouseofscience.com/
    The space is also further crowded by several not-for profits.
    This business model is possible because experiments for young children may be cheap to realize, unlike any experiment that would matter to a teenager or adult.
  • creating a private university, for profit or not. Of course, at this point, you would be either:
    • competing against the reputation and funding of century old universities
    • or be offering more boring, lower tech or techless courses, to (God forbid the phrasing) "worse students", i.e. at a "worse university"
Teenagers and young adults:
  • don't have money to give you if you want to "help them learn for real"
  • are somewhat forced to obtain their "reputable university" reputation to kickstart their careers
It is this perfect storm that places this specific section of education in such a bad shape that it is today.
This project is likely to fail. It could become the TempleOS of wikis. The project' autism score is quite high. It might be an impossible attempt at a lifestyle business. But Ciro is beyond caring now. It must be done. Other things that come to mind:
Dangerous combination:
One man with a laptop and a dream.
and for any crazy person who might wish to join: Men Wanted for Hazardous Journey.
Video 1.
One Man's Dream - Ken Fritz Documentary (2021)
Source.
In some ways, Ciro was reminded of OurBigBook.com by this documentary. Ken built his ultimate audio system without regard to money and time, to enjoy until he dies. Ciro is doing something similar. There is one fundamental difference however: everyone can enjoy a website all over the world.
A bit ominous though that the whole thing was eventually sold off for a fraction of the building cost: www.washingtonpost.com/style/interactive/2024/ken-fritz-greatest-stereo-auction-cost/.
If enough people use it, we could let people sell knowledge content through us.
Teachers have the incentive of making open source to get more students.
Students pay when they want help to learn something.
We take a cut of the transactions.
However this goes a bit against our "open content" ideal.
Forced sponsorware would be a possibility.
Would be a bit like Fiverr. Hmmm, maybe this is not a good thing ;-)
Not a fun of giving up control for such a low-maintenance cost venture... but keeping a list just in case...

Articles by others on the same topic (0)

There are currently no matching articles.