Oh, did not notice the corporate engineering thing at first. We don't have one after being acquired, but when we did the motivation was basically for recruiting purposes. Also surprisingly for internal documentation, people go to Google which indexes public websites but they don't search internal Confluence and Github Wiki articles
If you want to know why I think blogging - or “writing early/often/informally in public” is important, here’s some reasons.
- I don’t believe I know something unless I can disseminate that information.
- I need feedback on what I supposedly “know”. The mild embarrassment of friends engaging with my writing and giving me feedback is a fantastic way to learn.
- It’s practice for communicating hard ideas to people that don’t share my background.
- It is a natural extension of my interest in the topic.
- It’s a natural milestone on a side project - explaining what I built and why
- It highlights my expertise and markets me to employers.
- It is practice for communicating hard concepts to others or persuading them
- therapy to rant about the state of some topic
- as a way of writing down information that i can share with colleagues now and in the future
- to seed google with things past me learned and wants future me to find when they’re stuck
- to share something cool I learned or figured out
- to amplify someone or an event, article, etc I really want to support
- to fully own my writing away from any specific social media site
- just because I like attention :)
And many many more
i am working on turning my portfolio into a docusaurus site
i like it because it offers:
markdown docs w/ markdown diagrams, markdown blog, pages (as JSX)
- I'll use the docs aspect for two sections:
1. a set of portfolio projects
2. a set of boilerplate projects as a demo of my favorite devops & dev stack along with a brief description & tutorial for setting up the boilerplate.
- the pages aspect as the main page of my portfolio website, and maybe 1-2 other pages (perhaps one on career progression and one on the value proposition of my services)
- and then I'll have a markdown blog easily available as well, which I plan to use once a month or so to discuss what I've learned that month.
seems like a good & organized setup to me.
Now I keep my own personal technical blog that I consider a technical diary of the things I learn each month.
For devs who write, I do it as notes to myself or others when I think I figured out something useful, especially if it was originally unclear or I didn’t find any helpful examples. I appreciate everything I’ve read by others and I feel like contributing.
Since I believe in the value of writing, I can understand devs doing corporate blogging. They’re a team player and want to promote the place they work at. Maybe they make a real impact on marketing and recruiting and like playing on a winning team. Getting paid to talk about and evangelize tech is pretty cool.
Edit: fix typo.
- how to make - is - new features in Worst thing is there are some good pieces of insight but they get buried by the rest
personal engineering blogs tend to be something the author wanted to document so they could look back on later or thought that others would find the problem/solution cool