Topics Top articles New articles Updated articles Top users New users New discussions Top discussions New comments+ New article
Ciro Santilli is a collector at heart. But a collector of knowledge.
His uncle, which Ciro rassembles in many ways, was like that. But he collected physical objects such as wines and stamps. Or even worse, objects that were meant to be collected such Panini soccer sticker Albums! This Ciro looks down on.
With computers, knowledge takes no physical space and can be immediately shared with the hole world, and there is great beauty to that, as you can just keep collecting forever without filling up your house.
But of course, physical or not, all attachments futile.
Like other types collecting, once Ciro decides that "he must know everything about a given subject", he will keep coming back to that subject over and over. Not in a systematic way of course, since Ciro is a lazy bastard, but he will keep coming back for a very long time, and eventually become an expert at it.
This compulsive hoarding, together with Ciro Santilli's bad old event memory, are the fundamental reasons for OurBigBook.com.
How Ciro Santilli manages to write so much by Ciro Santilli 35 Updated 2024-12-23 +Created 1970-01-01
- Suck at your job:
- Have bad memory so you have to take notes: Ciro Santilli's bad old event memory
- Be a compulsive knowledge hoarder: Ciro Santilli's knowledge hoarding
- Seek glory over money: Ciro Santilli's selfish desires
- Try to make a carrier out of it: OurBigBook.com
- Be born compassionate: Ciro Santilli's self perceived compassionate personality
- He doesn't actually write that much, but when he does he focuses on higher impact stuff, see remarks about "He doesn't like to refresh the homepage looking for easy reputation" on Section "Ciro Santilli's Stack Overflow contributions"
- Contribute in a place where it is super easy for people to give you upvotes if they like your stuff. This way, you will see the uploads, and that will motivate you to re-read your content and make it more perfect with additions and corrections.
Let's see:
- www.linkedin.com/in/xahlee/
- xahlee.org/Nice Second brain vibe.
Siphon my knowledge into your brain. Assimilate my sensibilities to your spine.
- youtu.be/a6J62TwOreY?t=271 OMG he also uses a Kinesis Advantage 2 keyboard-like keyboard! Maybe there is something here after all.
- he's also a mad tutorial writer: xahlee.info/Wallpaper_dir/c4_Derivation.html#gc2.2.2.1 like Ciro's Stack Overflow
- www.patreon.com/xahlee £835.2/month from ony 27 members as of 2023, holy crap not bad!
- he was in a bad spot as of 2014: xahlee.info/emacs/misc/xah_as_good_as_dead.htmlThread: www.reddit.com/r/programming/comments/25pypq/im_about_as_good_as_dead_the_end_of_xah_lee/
i live on $3 per day for food in past 3 years. Eating noodles and oats with salt
One is reminded of Chill and eat your bread in peace and Quote "Omar Khayyam's chill out quote". xahlee.org/PageTwo_dir/Personal_dir/xah.html autobiography is also of interest.
Insanely active poster on Stack Overflow 4chan post (2023-07-03) by Ciro Santilli 35 Updated 2024-12-23 +Created 1970-01-01
archive.ph/Dd3aC web.archive.org/web/20230709141533/https://desuarchive.org/g/thread/94445084/#94448535 desuarchive.org/g/thread/94445084/#94448535
Title reply because they can't Ctrl+F: How Ciro Santilli manages to write so much
Most of the thread went into pro/anti gay trashtalk due to Ciro using Gay Putin at the time on his Stack Overflow profile as a useless way to protest the Russian invasion of Ukraine.
Some comments:
How does this guy manage to be so active on Stack Overflow? I feel like this disgusting avatar is on at least a quarter of all the active posts.
The answers are always pretty good though.
I came across this schizo's github once, but I had forgotten his name
Reply: it is publicly known that Putin is homophobic as fuck and hates that picture. Therefore we use it. If Putin were heterophobic, we'd post him as hetero.
The only new information:
Reminds me of Xah Lee.
Accounts controlled by Ciro Santilli by Ciro Santilli 35 Updated 2024-12-23 +Created 1970-01-01
Ciro Santilli controls the following accounts.
With non-trivial activity:
- github.com/cirosantilli on GitHub
- stackoverflow.com/users/895245 on Stack Overflow
- www.linkedin.com/in/cirosantilli on LinkedIn
- www.youtube.com/c/CiroSantilli on YouTube
- Twitter: see Section "Ciro Santilli's Twitter accounts"
- archive.org/details/@cirosantilli2 on the Internet Archive. Was archive.org/details/@cirosantilli but got deleted due to an "admin error" and the old username cannot be restored![ref]
- en.wikipedia.org/wiki/User:Cirosantilli2 and commons.wikimedia.org/wiki/User:Cirosantilli2: Ciro tries to upload all educational CC content he creates to Wikimedia Commons as an extra backup and sometimes to use in Wikipedia pages
- www.facebook.com/cirosantilli/ Ciro accepts all friend requests there, but expect a few non-technical posts. Unless you look like a massive honeypot account, please send context in advance in that case.
- www.quora.com/profile/Ciro-Santilli
- www.reddit.com/user/cirosantilli/ is Ciro's Reddit account, mostly computer and China topics
- maps.app.goo.gl/npV35XTppSBTmNqC8: Google Maps. Ciro Santilli likes to make additions to certain niche topics that are missing, having reached Local Guide Level 6 as of 2024. He can't do as much as he'd like so as to not reveal his current city however.
Trivial activity only:
- seqanswers.com/forums/member.php?u=90053
- answers.gazebosim.org/users/2289/cirosantilli/
- 4programmers.net/Profile/86786
- 500px.com/p/cirosantilli
- 9gag.com/u/cirosantilli
- addons.mozilla.org/en-US/firefox/user/cirosantilli/
- agoradesk.com/user/cirosantilli
- androidforums.com/members/ciro-santilli.1918307
- app.element.io/#/user/@cirosantilli:matrix.org. Proof: matrix.to/#/!OisxJPszSYdWdwXrrL:matrix.org/$YbrChbGFvlgYiDM5E2OgWXSp0vy7ayLfGkCXftAUyTI?via=matrix.org
- archive.org/details/@ciro_santilli_ourbigbook created during the account deletion mess.
- ask.libreoffice.org/en/users/2352/cirosantilli/
- bbs.archlinux.org/profile.php?id=116270
- bitcointalk.org/index.php?action=profile
- brilliant.org/profile/ciro-il1uxz/
- bugzilla.gnome.org/page.cgi?id=describeuser.html&login=ciro.santilli@gmail.com
- cirosantilli.blogspot.com/
- cirosantilli.itch.io
- cirosantilli.livejournal.com/profile
- cirosantilli.medium.com/ on Medium
- cirosantilli.substack.com/
- cirosantilli.wordpress.com/ on WordPress
- codeforces.com/profile/cirosantilli reverse proof codeforces.com/blog/entry/98393
- coderwall.com/Ciro%20Santilli Note that space on the username. Beauty.
- community.arm.com/people/cirosantilli
- community.atlassian.com/t5/user/viewprofilepage/user-id/680821
- community.fandom.com/wiki/User:Cirosantilli
- community.plos.org/people/cirosantilli
- community.skype.com/t5/user/viewprofilepage/user-id/2646858
- community.zimbra.com/members/cirosantilli
- connect.mozilla.org/t5/user/viewprofilepage/user-id/46889
- del.icio.us/cirosantilli
- dev.to/cirosantilli
- developer.mbed.org/users/cirosantilli/
- devtalk.nvidia.com/member/2118846/
- droit-finances.commentcamarche.net/profile/user/cirosantilli
- en.gravatar.com/cirosantilli
- en.wikipedia.org/wiki/User:Ciro.santilli also belongs to Ciro, but he lost the password
- eternagame.org/web/player/260828/
- figshare.com/authors/Ciro_Santilli/656781
- forums.developer.nvidia.com/u/cirosantilli
- forum.osdev.org/memberlist.php?mode=viewprofile&u=16372
- forum.pine64.org/member.php?action=profile&uid=17386
- forum.videolan.org/memberlist.php?mode=viewprofile&u=173503
- forum.xda-developers.com/member.php?u=7116837
- forums.androidcentral.com/members/cirosantilli-2734491
- forums.lenovo.com/user/viewprofilepage/user-id/1561639
- framasphere.org/people/78a975c0b6c40133a3032a0000053625 framasphere.org/posts/1519871
- freesound.org/people/cirosantilli
- gitlab.com/u/cirosantilli
- hackaday.io/cirosantilli
- hinative.com/en-US/profiles/5276462
- home.gamer.com.tw/homeindex.php?owner=cirosantilli but can't post anything publicly because cannot verify phone in many countries
- huggingface.co/cirosantilli
- identity.kde.org/index.php?r=people/view&uid=cirosantilli
- imgur.com/user/cirosantilli/about: Proof: imgur.com/gallery/mexv1Bk/comment/1734086983
- jsfiddle.net/user/cirosantilli/
- kiwifarms.net/members/cirosantilli.82011/
- launchpad.net/~cirosantilli
- leanpub.com/u/cirosantilli
- leetcode.com/cirosantilli/
- makandracards.com/ciro-santilli
- mastodon.social/@cirosantilli
- nanohub.org/members/146301/
- next-episode.net/user/cirosantilli/
- openclipart.org/artist/cirosantilli. TODO but not yet able to login after the "first upload". But it did get uploaded: openclipart.org/artist/cirosantilli.
- opencollective.com/ciro-santilli
- open.spotify.com/user/cirosantilli
- orcid.org/0000-0003-2895-7763
- parler.com/profile/cirosantilli/posts
- paypal.me/cirosantilli. United Kingdom account.
- peerj.com/cirosantilli/
- profile.edx.org/u/ciro_santilli
- profiles.3dgames.com.ar/profiles/1002278
- protonmail.uservoice.com/users/6491333990-ciro-santilli
- pypi.org/user/cirosantilli/
- raidforums.com/User-cirosantilli
- rubygems.org/profiles/cirosantilli
- software.intel.com/en-us/user/1090688
- soundcloud.com/cirosantilli
- sourceforge.net/u/cirosantilli/profile/
- stackshare.io/cirosantilli
- steamcommunity.com/id/cirosantilli/
- subreply.com/cirosantilli
- support.discord.com/hc/en-us/profiles/427813342894 on the Discord forum
- support.mozilla.org/en-US/user/cirosantilli
- tabmixplus.org/forum/memberlist.php?mode=viewprofile&u=59846
- talk.commonmark.org/users/cirosantilli
- talk.jekyllrb.com/users/cirosantilli
- talks.cam.ac.uk/user/show/81142
- tatoeba.org/eng/user/profile/cirosantilli
- telegram.me/cirosantilli on Telegram
- trac.ffmpeg.org/wiki/Waveform?action=history username
cirosantilli
- tuleap.net/users/cirosantilli
- tuleap.ring.cx/users/cirosantilli
- twittercommunity.com/users/cirosantilli/activity
- wefunder.com/cirosantilli
- wise.com/pay/me/cirod3. The name shows as "Ciro Duran Santilli" and that's correct.
- wiki.qemu.org/User:Cirosantilli
- www.airbnb.com/users/show/45794827
- www.behance.net/cirosantilli
- www.bibsonomy.org/user/cirosantilli
- www.biostars.org/u/50170/
- www.bountysource.com/people/25676-ciro-santilli
- www.bulletphysics.org/Bullet/phpBB3/memberlist.php?mode=viewprofile&u=11704
- www.codewars.com/users/cirosantilli
- www.codingame.com/profile/cddd0a711c22d97e8264361f7c8205567563841
- www.coursera.org/user/f65b08c191d792eb809fe2808d771ee7
- www.dailymotion.com/cirosantilli
- www.deviantart.com/cirosantilli
- www.digitalocean.com/community/users/cirosantilli
- www.ebay.com/usr/cirosantilli
- www.edaboard.com/member587087.html
- www.flickr.com/people/cirosantilli/
- www.freecodecamp.org/fcc8f660b91-167c-4b04-a8da-5d50cdb46def
- www.f6s.com/cirosantilli
- www.f6s.com/cirosantilli1
- www.gitbook.com/@cirosantilli
- www.hackerrank.com/cirosantilli
- www.hackster.io/cirosantilli
- www.html5gamedevs.com/profile/30103-cirosantilli/
- www.imdb.com/user/ur59802249 on IMDb
- www.instagram.com/cirosantilli/ Impossible to disable their notifications without removing your email. So all their notifications go to trash.
- www.kaggle.com/cirosantilli
- www.lesswrong.com/users/ciro-santilli on LessWrong
- www.linux.org/members/ciro-santilli.62540/
- www.linuxquestions.org/questions/user/cirosantilli-688439/
- www.meetup.com/members/252568305/
- www.mentebinaria.com.br/profile/1987-ciro-santilli/
- www.metacritic.com/user/cirosantilli
- www.metaculus.com/accounts/profile/163587/
- www.mohu.rocks/people/cirosantilli
- www.mudhut.com/user/1995000
- www.myopportunity.com/en/profile/ciro-santilli
- www.npmjs.com/~cirosantilli
- www.opengl.org/discussion_boards/member.php/40269-cirosantilli
- www.openstreetmap.org/user/Ciro%20Santilli
- www.patreon.com/cirosantilli
- www.physicsforums.com/members/cirosantilli.422056/
- www.pixiv.net/en/users/64347194
- www.plurk.com/cirosantilli
- www.raspberrypi.org/forums/memberlist.php?mode=viewprofile&u=273389
- www.shadertoy.com/user/cirosantilli
- www.strava.com/athletes/47913768
- www.tastekid.com/ciro.santilli
- www.ted.com/profiles/5822760
- www.thestudentroom.co.uk/member.php?u=5930160
- www.tiktok.com/@cirosantilli2
- www.transifex.com/user/profile/cirosantilli
- www.tripadvisor.com/members/cirosantilli
- www.twitch.tv/cirosantilli
- www.whatdotheyknow.com/user/ciro_santilli/profile
Profiles without URLs (OMG...):
- Discord: username
cirosantilli
, previouslycirosantilli#8921
Accounts in Chinese websites. These accounts might be banned or altered or offer other limitations, so Ciro only communicates briefly through them. All communication through those channels should obviously be assumed to be compromised:
- bbs.nibaedu.com/index.php?m=space&uid=70
- www.renren.com/338003848/profile
- www.tianya.cn/109285544 (can't post, no cell phone)
- hacpai.com/member/cirosantilli unable to login as of 2019-10-12, reason unclear, either ban or website too crappy.
- pincong.rocks/people/cirosantilli Lost account tested as of 2022-11 and likely much earlier. Last existing password not working, and there doesn't seem to be a reset password button. Creating cirosantilli2
- pincong.rocks/people/cirosantilli2
- tieba.baidu.com/home/main?id=5cd56369726f73616e74696c6c69c944
- v2ex.com/member/cirosantilli: Ciro was blocked and or account deleted on 2020-07-23: cirosantilli.com/china-dictatorship/v2ex
- v2ex.com/member/cirosantilli2: was created by someone else most likely and cannot be re-registered. Also blocked.
- v2ex.com/member/cirosantilli3: Ciro created this new account November 2023, let's see how long it lasts.
- www.zhihu.com/people/cirosantilli. Ciro was prevented from posting in 2018-06-25, and the account and all content mentioning him were taken down in 2019-11-03.
- www.weibo.com/p/1005055601627311: started requiring a cell phone to login in 2020, and Ciro didn't want to give his cell phone number to the CCP and didn't have the patience to manage a secondary phone number, so he is not logging in for now. The account was blocked in 2021: cirosantilli.com/china-dictatorship/ciro-santillis-weibo-block
Accounts in Russian websites:
Dead websites:
- www.citeulike.org/user/cirosantilli (2019-05)
Brain-computer interfaces could be the next big thing by Ciro Santilli 35 Updated 2024-12-23 +Created 1970-01-01
Main article: Section "Brain-computer interface".
This is one of the deep tech bets that Ciro Santilli would put his money in as of 2020.
How hard could it be? You just have to learn the encoding of the neural spine/eyes/ear, add an invasive device that multiplexes it, and then the benefits could be mind blowing.
Interestingly and obviously, the initial advances in the area are happening for people that have hearing or vision difficulties. Since they already have a deficient sense, you don't lose that much by a failed attempt.
Hearing is likely to be the first since it feels the simplest. Ciro heard there are even already clinical applications there. TODO source.
Quantum computing could be the next big thing by Ciro Santilli 35 Updated 2024-12-23 +Created 1970-01-01
He's a bit lazy to explain why here, but Googling will be more than enough.
There is a risk it will fizzle and the bubble pop, like any revolution.
But recent developments are making it too exciting to ignore.
Ciro Santilli is very happy to meet people with related interests, he really loves his like-minded online friends. Even if you don't have something a specific goal in mind for the contact, please just say hi.
To contact Ciro publicly about any general subject that is not covered in a more specific GitHub repository, including saying hi or suggestions about his website either:
- create a GitHub issue at: github.com/cirosantilli/cirosantilli.github.io/issues/new or Giscus thread
- at mention Ciro's main Twitter account
For comments about China, first read:
and then create a GitHub issue at: github.com/cirosantilli/china-dictatorship/issues/new
Publicly viewable contact is preferred if possible to more effectively share Ciro's wisdom with the world.
But if you feel more comfortable with private contact, no problem, either:
- email:
cirosantilli
with provider ProtonMail which has domain nameproton.me
. All lowercase and removing the placeholder characters<
and>
. Note that Ciro also controls the Gmail address with that same username, and keep in mind that dots are ignored in Gmail addresses. But ProtonMail preferred because why should we give our private minds to the CIA by default? Push notifications disabled. - Signal: username
cirosantilli.89
signal.me/#eu/BuJjV0enXYTOnFFc1FZV5LFcWodL1a2Oy9VZ5uyQU7xrYxqw+npIcaHBqghWudrI. 89 is a reference to Ciro Santilli's birth year 1989. Push notifications enabled, but treat like email unless we are actively chatting back and forth.
For other less good methods that will also work, use direct messages of the following profiles from under Section "Accounts controlled by Ciro Santilli":
- LinkedIn: www.linkedin.com/in/cirosantilli
- Reddit: www.reddit.com/user/cirosantilli
- Facebook: www.facebook.com/cirosantilli
- Telegram: telegram.me/cirosantilli. Note that end-to-end encryption is present on secret chats only, which don't have device sync. Ridiculous.
If you are a privacy freak or are going to tell Ciro state secrets Ciro has this GNU Privacy Guard public key: pubkey.gpg.
Disqus comments were removed from his website in 2019-05-04, a manual dump is available here, removal rationale at: why Ciro Santilli removed Disqus comments from his website in 2019-05-04.
These are people which Ciro never met personally, and who might not know that Ciro exists, or might never had any direct 1-2-1 online contact with Ciro, but Ciro is convinced are his brothers in some other dimension due to how many opinions or behaviours he feels they share:
- Dan Dascalescu due to articles such as:
- English as a universal language by Dan Dascalescu (2008)
- www.reddit.com/r/TheoryOfReddit/comments/9oujwf/why_archiving_old_threads_is_a_bigger_problem/ see also online forums that lock threads after some time are evil
- web.archive.org/web/20130922192354/http://wiki.dandascalescu.com/reviews/online_services/web_page_archiving see also web archiving
- random posts on OpenStreetMap, and about China: help.openstreetmap.org/questions/29300/legality-status-of-mapping-activity-in-china?page=1&focusedAnswerId=42167#42167
- kenorb see also Ciro Santilli's Stack Overflow contributions
- Gwern Branwen
Some other idealists that are a bit further out but with some similarities:
- Sylvain Poirier
- Gabriel Staples
- gabrielstaples.com/#gsc.tab=0
- github.com/ElectricRCAircraftGuy
- stackoverflow.com/users/4561887/gabriel-staplesYes, sir.
Working hard to make the Internet more complete.
At github.com/sponsors/ElectricRCAircraftGuy:I'd really like to work on open source projects more, but the need for a full-time job makes that difficult. If you can sponsor me, you help me get one step closer to my dream of not having to work a traditional "day job" anymore, so I can contribute more to the open source community, do more to educate, and do more to confront new and challenging ideas.
Ciro Santilli also things of those people as being part of his 108 Stars of Destiny troupe.
Ciro sometimes ponders why is it so hard to find people online that you truly love and admire. Maybe it is for similar reasons why it is also hard in the real world: the great variety of human interest, and the great limitation of our attention spans. But online, where we have access to "everyone", shouldn't it should be easier? Not naturally finding such people is perhaps one of the greatest failings of our education system.
Non-technical skills were moved to: Ciro Santilli's skills.
This has not been updated since 2016 after Ciro got a job, because it is too hard to put a number on any skill.
What really matters are the most important projects done by Ciro Santilli.
If Achilles' had his heel, Ciro had his knee.
First during University in Brazil while trying a kick up during the development of Cirodance his knee went a bit weird for a few weeks.
Then, just after arriving in France for École Polytechnique, the boys were playing indoor soccer, and to impress the girls Ciro was playing really hard, even took off his shirt, and suddenly when he was running by himself his knee snapped, he fell and it hurt like hell.
Ciro was on crutches for a few weeks, but the inflammation went away, but then he tried to play more soccer, but the knee was not as stable as before, and once he tried to run full speed, it slipped and hurt him a bit more (less severely) and so he gave up. For some reason it was not visible on the tomography made at the hospital.
Maybe Ciro should have investigated more though, certainly an experienced doctor could have done a hand pressure exam to determine which joint was damaged manually even. That was a medical failure.
So from this day on Ciro gave up on all interesting sports, and confined himself to more repetitive stuff like gym weights and cycling: Section "Ciro Santilli's sport practice". At Polytechnique he was forced to take up swimming as his mandatory sport, that was unbearably boring.
This defect is likely genetic since a close relative had similar problems.
But oh well, his then not-even girlfriend was impressed enough by the soccer or sorry enough for the sucker to marry him, so it worked out.
What if I fail? What if one month in I discover that the project is undoable for some reason? Etc.
Nothing can scare a man as much as allowing him to pursue his dream! Because then he may find his dream was purely an empty illusion.
But still, we must try.
DNS configuration of Ciro Santilli's website by Ciro Santilli 35 Updated 2024-12-23 +Created 1970-01-01
AKA how this GitHub page gets served under the domain: cirosantilli.com
Ciro only touches this very rarely, and always forgets and go into great pain whenever a change needs to done, so it is important to document it.
The last change was of 2019-07-07, when Ciro moved from the www subdomain www.cirosantilli.com to the APEX cirosantilli.com. A redirect is setup from the www subdomain to APEX.
GoDaddy DNS entries:
Type Name Value TTL
A @ 185.199.108.153 1 Hour
A @ 185.199.109.153 1 Hour
A @ 185.199.110.153 1 Hour
A @ 185.199.111.153 1 Hour
CNAME www cirosantilli.github.io 1 Hour
Moved cirosantilli.com to Porkbun 2022-02, unfortunatly records were not automatically updated and domain went down for a bit, upadded to new entries for IPv6 as well which are not documented by GitHub:
TYPE HOST ANSWER TTL PRIORITY OPTIONS
A cirosantilli.com 185.199.108.153 600
A cirosantilli.com 185.199.109.153 600
A cirosantilli.com 185.199.110.153 600
A cirosantilli.com 185.199.111.153 600
AAAA cirosantilli.com 2606:50c0:8000::153 600
AAAA cirosantilli.com 2606:50c0:8001::153 600
AAAA cirosantilli.com 2606:50c0:8002::153 600
AAAA cirosantilli.com 2606:50c0:8003::153 600
CNAME www.cirosantilli.com cirosantilli.github.io 600
where the IPs are obtained from: help.github.com/en/articles/setting-up-an-apex-domain#configuring-a-records-with-your-dns-provider (archive).
- Custom domain:
cirosantilli.com
- Enforce HTTPS: checked
And the CNAME file is tracked in this repository: CNAME.
However it won't remain like that for long, because it will be migrated to OurBigBook.com, and therefore become a brain dump of society itself.
Ciro Santilli's documentation superpowers by Ciro Santilli 35 Updated 2024-12-23 +Created 1970-01-01
Ciro Santilli has the power to document stuff in a way that makes using them awesome, as evidenced by his his Stack Overflow contributions (notably those in the best articles by Ciro Santillis), and other online contributions.
If your project does something awesome, hiring Ciro means that more people will be able to notice that it is actually awesome, and use it.
He likes to do this in parallel to contributing new features, quickly switching between his "developer" and "technical documentor" hats.
This means of course that he will develop new features a bit slower than others, but he feel it is more valuable if end users can actually use your project in the first place.
His technique is to provide upfront extremely interactive and reproducible getting started setups that immediately show the key value of the project to users.
He backs those setups with:A prime example of kind of setup is Ciro's Linux Kernel Module Cheat.
- scripts that automate the setup much as possible to make things enjoyable and reproducible
- a detailed description of the environment in which he tested: which OS, version of key software, etc.
- a detailed description of what is expected to happen when you take an action, including known bugs with links to bug reports
- theory and rationale on the sections after the initial getting started, but always finely interspersed with concrete examples
- all docs contained in a Git-tracked repo, with the ability to render to a single HTML with one TOC
- short sentences and paragraphs, interspersed with many headers, lists and code blocks
While he create this setup, he inevitably start to notice and fix:
- bugs
- annoyances on the public interface of the project
- the devs were using 50 different local scripts to do similar things, all of them semi-broken and limited. Every new hire was copying one of those local scripts, and hacking it up further.
- your crappy build / test / version control setup
Exploiting this skill, however, requires you to trust him.
When he tells to managers that he's good at documenting, they always say: great, we need better documentation! But then, one of the following may happen:
- managers forget that they wanted good documentation and just tell him to code new features as fast as possible
- they don't let him own the getting started page, but rather and expect him to try and fix the existing crappy unfixable existing getting started, without stepping on anyone's pride in the process >:-)This makes him tired, and less likely to do a good job.Good documentation requires a large number of small iterative reviews, and detailed review of every line is not always feasible.Too many cooks.
Ciro's passion for documentation and tooling has the effect that if you have crappy documentation and tooling and don't want them to be fixed, Ciro will end up trying to fix those tools instead of doing what you tell him to do anyways, which might lead to him quitting because he can't stand the tools, or you firing him because he's not doing the job you think I should be doing. So please, don't bother hiring Ciro if you have crappy documentation and tooling.
Psychological analysis of why Ciro has this gift: How Ciro Santilli manages to write so much.
Ciro often has the following metaphor in his mind:
New discoveries are like very rough trails where you have to cut through heavy bushes (an original research paper).After a brave explorer goes through this rough path for the first time and charts it, it does become much easier for others to follow it later on, but it still requires a lot of effort to go through them, because there are still a lot of rough bushes and some parts of the map are not very clear (reading and reproducing the research paper to further advance the state of the art).As enough people start going through, the probability that someone with a bad memory ends up walking it increases, and that person ends up pounding the earth into a beaten track and increasing the trail clearance of the beginning of the trail at least (review paper).There finally comes a point when even the local government starts to notice this trail is important, and pays someone to add some stone pavement and rails on the most exposed parts of the trail (post and undergrad education).And at last, Ciro Santilli comes with a bulldozer and creates an autoroute that thousands of people can cruise at high speed without any effort (Q&A, open knowledge HTML websites).
Ciro's documenation obsession is partly part of his braindumping effort of dumping his brain into text form, which he has been doing through Ciro Santilli's website.
Pinned article: ourbigbook/introduction-to-the-ourbigbook-project
Welcome to the OurBigBook Project! Our goal is to create the perfect publishing platform for STEM subjects, and get university-level students to write the best free STEM tutorials ever.
Everyone is welcome to create an account and play with the site: ourbigbook.com/go/register. We belive that students themselves can write amazing tutorials, but teachers are welcome too. You can write about anything you want, it doesn't have to be STEM or even educational. Silly test content is very welcome and you won't be penalized in any way. Just keep it legal!
We have two killer features:
- topics: topics group articles by different users with the same title, e.g. here is the topic for the "Fundamental Theorem of Calculus" ourbigbook.com/go/topic/fundamental-theorem-of-calculusArticles of different users are sorted by upvote within each article page. This feature is a bit like:
- a Wikipedia where each user can have their own version of each article
- a Q&A website like Stack Overflow, where multiple people can give their views on a given topic, and the best ones are sorted by upvote. Except you don't need to wait for someone to ask first, and any topic goes, no matter how narrow or broad
This feature makes it possible for readers to find better explanations of any topic created by other writers. And it allows writers to create an explanation in a place that readers might actually find it. - local editing: you can store all your personal knowledge base content locally in a plaintext markup format that can be edited locally and published either:This way you can be sure that even if OurBigBook.com were to go down one day (which we have no plans to do as it is quite cheap to host!), your content will still be perfectly readable as a static site.
- to OurBigBook.com to get awesome multi-user features like topics and likes
- as HTML files to a static website, which you can host yourself for free on many external providers like GitHub Pages, and remain in full control
- Internal cross file references done right:
- Infinitely deep tables of contents:
All our software is open source and hosted at: github.com/ourbigbook/ourbigbook
Further documentation can be found at: docs.ourbigbook.com
Feel free to reach our to us for any help or suggestions: docs.ourbigbook.com/#contact