News for hackers. Stuff that matters.
Re:Stopping at 90% by simonw on Wednesday August 02, 2023 @10:16AM (#36971213)
I've started to consider "commit to writing about it" as the price I have to pay for giving into the lure of another project. It's one of the main reasons I publish so much content on https://simonwillison.net/ and https://til.simonwillison.net

A project with a published write-up unlocks so much more value than one which you complete without giving others a chance of understanding what you built.

I've maintained internal blogs (sometimes just a Slack channel or Confluence area) at previous employers for this purpose too.

Re:Stopping at 90% by marginalia_nu on Wednesday August 02, 2023 @10:56AM (#36971764)
Yeah.

I also find a side benefit of writing about what you're doing (or talking about it) other than visibility and education is that it makes you understand it better as well in a very tangible way.

Re:Stopping at 90% by freshbakedbread on Thursday August 03, 2023 @08:10AM (#36984715)
Im interested to learn more about the internal blogs you set up at previous employers. Do employees use it to write about their ongoing projects? Thanks for sharing!
Re:Stopping at 90% by simonw on Thursday August 03, 2023 @04:49PM (#36991648)
I've mostly tried to lead by example: I start an internal blog, write about my projects and hope that others will follow my need and start their own.

I've not had a great deal of success with encouraging others to start doing this, but I still find that the impact my own work has within the company is greatly improved if I have somewhere that I can write about it.

I don't expect others to actually read my internal blog on an ongoing basis, but I get a great deal of value out of being able to send links to posts on it to people. I wrote up a big essay about how to use our internal analytics tool once, for example, and shared that with anyone who asked how that thing worked.

I've used a few different mechanisms for these:

- A Slack channel. Free to setup, anyone who wants to follow along can join the channel.

- A confluence blog - confluence has a "blog" feature which you can just start using.

- An organization private GitHub repo full of markdown files.

I did eventually publish the internal blog posts I wrote at one organization (an organization which has since shut down) - I shared those here: https://simonwillison.net/series/vaccinateca/