#Better Documentation0 debatiendo

Hi Community members, 

I'm embarking on a Documentation project looking to record the various fields, objects, automation and business processes my NFP has within our customised Salesforce environment. 

Is there a particular format or platform that you have used to record your documentation that you would recommend? Or perhaps suggest I steer clear of?

(We have incomplete documentation from our implementation five years ago within Confluence and Jira but nothing that is comprehensive enough to train an incoming admin or support organisation to ask good questions.) 

Thanks for your time 

Is there better documentation with perhaps step by step instructions for using "the API" to load badges for a group of users?  The documentation online here - https://help.salesforce.com/articleView?id=networks_recog_badges_via_api.htm&type=5 - does little to help me and maybe most other community managers (most of us are not programmers) to understand how to bulk deliver a badge to a group of users. 

What API is "the API"?  What is the endpoint?  Any suggestions for creating the file?  I have a bit of familiarity with Postman to coble things together on occasion but that is when I have had great documentation to refer to.   

Does anyone have more details they can add and have they got "the API" to work?  

Thanks .