Of course yes! You should add examples of API use too. I hate how documentation without examples is dysfunctional - see example of CMake documentation.