What tools do you use to build Internal docs?

I've always used Confluence though I've always found the experience a bit sluggish and non-enjoyable. I've always been looking for other solutions on the side but...without much success.

One product I've been watching particularly is: https://readme.com

Notion.so

You can look at SendMan’s docs at https://docs.sendman.io. We use:

1. mkdocs-marerial for freeform textual markdown documentation.
2. redoc for API docs based on OpenAPI (formerly swagger) documentation.

I personally don’t like Confluence - and would recommend Notion for internal knowledge bases. If you maintain your internal docs as you would your external ones - it can lead to higher standards (at obviously higher costs).

We've used Confluence and Notion for the 2nd part of the question (examples like pages teaching new hires about parts of the stack).

I think Confluence is a little more difficult to use. For the most part the only people that contributed to the Confluence pages were people that were required to as part of their job (at our company the project managers). We never saw broader usage with other team members.

At my new job we went with Notion we've gotten broader usage around the team.

For API documentation something like OpenAPI / Swagger I think is a much better option, especially if you can integrate it in a way where it autobuilds with your code as long as it is commented correctly. The auto-generating can be very effective and once other teams start relying on those docs, it gets easier to ensure engineers make sure they get added.

Also the fact that you can test API queries directly in the docs and see the results is better than a transcribed version in Confluence or Notion (that will also drift out of date over time).

Definitely suggest using Confluence for this

We use Slab.com for our sales/marketing/custom success/finance/admin team, and Phabricator Wiki for our development team.

Probably it's not what you need, but I recently used Docusaurus v2 for a public docs site. The experience was very smooth and straightforward.

https://docusaurus.io

Github.

Running joke - startups that are 'Github for X'. Why not just use Github?

We just create files, format them using markdown, everyone can see it. Boom.

If you're marketing guys don't know how to use Github, show them:

https://gitbook.com

Lots of Confluence users in here... does it have any advantages over Notion for internal docs?

Markdown files or Google docs, I hate Confluence

Confluence is a really good platform. I find it very useful for day to day documentation too!

I have try Docusaurus, and I like it 🙂

honestly, i've used notion...

... but most of our wiki is in github's wiki system. simple, we're all there anyways.

I use Confluence