Register a SA Forums Account here!
JOINING THE SA FORUMS WILL REMOVE THIS BIG AD, THE ANNOYING UNDERLINED ADS, AND STUPID INTERSTITIAL ADS!!!

You can: log in, read the tech support FAQ, or request your lost password. This dumb message (and those ads) will appear on every screen until you register! Get rid of this crap by registering your own SA Forums Account and joining roughly 150,000 Goons, for the one-time price of $9.95! We charge money because it costs us money per month for bills, and since we don't believe in showing ads to our users, we try to make the money back through forum registrations.
 
  • Post
  • Reply
Oysters Autobio
Mar 13, 2017
Thing with docs is that if you really want to bother with *any*, it's sort of all or nothing.

Either setup dedicated docs SSGs so your team can easily edit markdown in the same commit, or don't bother.

If all you can actually do is a sort of manual / half assed "expectation" that ppl will update the confluence, then don't bother.

If setting up markdown docs SSG sounds too onerous then it's probably not actually as important as you think it is. It's just not convincing to me that someone says something is mandatory, zero-fail or mission-critical but won't actually engineer something to support that.

Confluence is a wiki for fast business docs and project mgmt. Technical docs are a feature of the product.

Oysters Autobio fucked around with this message at 15:36 on Apr 7, 2024

Adbot
ADBOT LOVES YOU

Oysters Autobio
Mar 13, 2017

lol yeah I should've caveated that with an ironicat or something

  • 1
  • 2
  • 3
  • 4
  • 5
  • Post
  • Reply