Skip to content

antipaucity

fighting the lack of good ideas

Tag: documentation

finally starting to get some good docs amassed

Posted on 28 July 201825 July 2018 By antipaucity No Comments on finally starting to get some good docs amassed

I had a decent library of documentation, templates, hand-offs, slide decks, etc in my pre-Splunk consulting life (technically, I still have them). It’s nice to be finally getting a decent collection to draw from for my customers in my post-automation consulting life.

technical, work

document what didn’t work

Posted on 22 January 201822 January 2018 By antipaucity No Comments on document what didn’t work

In a recent episode of Paul’s Security Weekly, an off-hand comment was made about documentation: you shouldn’t merely document what to do, nor even why, but also what you tried that didn’t work (ie, augment the status quo). The upshot being, to save whomever comes to this note next (especially if it turns out to be yourself) effort you spent that…

continue “document what didn’t work” »

ideas, insights

there’s never enough documentation | there’s too much documentation

Posted on 11 October 201311 October 2013 By antipaucity 5 Comments on there’s never enough documentation | there’s too much documentation

Documentation is vital. There’s never enough. And there’s always too much. In general, these are the areas I find documentation to fail: Not Enough Too Much/Many why-tos (instead of how-tos) tutorials on things you need architecture explanation design philosophy “how we got here” “why we are here” future plans / roadmaps deltas from standards recording…

continue “there’s never enough documentation | there’s too much documentation” »

commentary, complaint, ideas, technical, work

new documentation should always augment the status quo

Posted on 9 October 20131 April 2021 By antipaucity 2 Comments on new documentation should always augment the status quo

In my line of work, I often need to create documentation for clients. Documentation in general is a Good Thing™. But good documentation’s goal should always be to augment and improve upon what already exists – not to supplant, downgrade, or muddle what already exists. A prime example of this has come up with a…

continue “new documentation should always augment the status quo” »

commentary, ideas, insights, personal, technical, work

organizational knowledge capture, retention, and dissemination

Posted on 10 February 201312 September 2022 By antipaucity 6 Comments on organizational knowledge capture, retention, and dissemination

Knowledge capture, retention, and dissemination has been an interest of mine for a long time. I have written about various aspects of it before. The most vital commodity any organization has is the knowledge of its members – it does not matter if it is a historical society, company, church, or school: the organizational knowledge…

continue “organizational knowledge capture, retention, and dissemination” »

commentary, education, ideas, insights, technical, work
March 2023
S M T W T F S
 1234
567891011
12131415161718
19202122232425
262728293031  
« Jan    
  • Patrick Henry 23 March 1775
  • Reincarnation by Wallace McCrae (adapted by Warren Myers)
  • Famed was Beowulf
  • Fuzzy Wuzzy (anonymous)
  • One bright morning in the middle of the night (various)

Books

  • Debugging and Supporting Software Systems
  • Storage Series

External

  • Backblaze
  • Cirkul
  • Digital Ocean
  • Fundrise
  • Great Big Purple Sign
  • Password Generator
  • PayPal
  • Tech News Channel on Telegram
  • Wish List

Other Blogs

  • Abiding in Hesed
  • Chris Agocs
  • Eric Hydrick
  • Jay Loden
  • Paragraph
  • skh:tec
  • Tech News Channel on Telegram
  • Veritas Equitas

Profiles

  • LinkedIn
  • Server Fault
  • Stack Overflow
  • Super User
  • Telegram
  • Twitter

Resume

  • LinkedIn
  • Resume (PDF)

Services

  • Datente
  • IP check
  • Password Generator
  • Tech News Channel on Telegram

Support

  • Backblaze
  • Built Bar
  • Cirkul
  • Digital Ocean
  • Donations
  • Fundrise
  • PayPal
  • Robinhood
  • Wish List

Copyright © 2023 antipaucity.

Powered by PressBook Green WordPress theme