I prefer reading someone's writeup than the code to implement the software product. With the write-up I can learn how the software works. The code is too hard to read to fit together the puzzle.
I read whitepapers to learn what others learned. I keep a list of whitepapers I am interested with on my GitHub profile.
I want people to spend lots of time writing what you did on GitHub to explain why your project is useful and how to use it. Some GitHub README.md are really good and explain the software well. Some libraries place documentation in the README.md
I journal computer software ideas and thoughts out in the open on GitHub. I am up to 700+ journal entries and they are in markdown and numbered paragraphs.
My interests are parallel computing, database internals, distributed systems, multithreading and scalability and futuristic software.
Links to my journal
https://GitHub.com/samsquire/ideas
https://GitHub.com/samsquire/ideas2