Documentation fails because we miss to work on it. On our todo-list it usually moves automatically to the bottom. “I can do this later”.
Here are some tips to write a documentation:
🖖 Small and steady – obvious thing. Reserve 30m every week to extend and refactor the documentation.
🧞♀️ In the process – For tracking implementation it helps to have a process how you extend the tracking: New product feature -> Tracking plan for new feature -> Documentation
👑 Share the results – Your big moment comes when someone asks you via slack about a specific data item (events, tables) and you simply send them the link to the docs.
🦁 Promote it – Every data team needs an internal newsletter, podcast, channel – use these channels to promote new documentation pieces.