tutorial vs referencia API: ¿Cuál es la diferencia?

En muchos sitios como: https://django-tables2.readthedocs.io vemos dos secciones:

1-tutorial
2-API-reference

¿Cuál es la explicación de las dos secciones? cual es la diferencia de ellos?

Si queremos usar desde la biblioteca, ¿cómo puedo iniciarlo e implementarlo? gracias

Answer

Un tutorial es generalmente una lección práctica guiada sobre cómo usar una API, que incluye ejemplos, preguntas frecuentes y consejos generales. Muy útil cuando no está demasiado familiarizado con la biblioteca y desea comprender qué hace, para qué se puede usar y cómo usarla.

La referencia de la API será documentación específica sobre la API (las funciones/datos a los que puede acceder como desarrollador), mucho más técnica y detallada, muy útil cuando tiene contexto y está buscando una herramienta específica, o tratando de depurar un problema específico.

Comience con el tutorial, luego consulte la documentación de la API cuando desee obtener más detalles. Una API bien documentada es increíblemente útil.