Учебник vs API refrence: В чем разница?
На многих сайтах, таких как: https://django-tables2.readthedocs.io мы видим два раздела:
1-tutorial
2-API-reference
Что такое два раздела объяснения? в чем их разница?
Если мы хотим использовать библиотеку, как я могу начать и реализовать ее? спасибо
Учебник - это, как правило, практический урок по использованию API, включающий примеры, часто задаваемые вопросы и общие советы. Очень полезно, когда вы не слишком хорошо знакомы с библиотекой и хотите понять, что она делает, для чего ее можно использовать и как ее применять.
API reference - это конкретная документация по API (функции/данные, доступные вам как разработчику), гораздо более техническая и подробная, очень полезная, когда у вас есть контекст и вы ищете конкретный инструмент или пытаетесь отладить конкретную проблему.
Начните с учебника, а затем обратитесь к документации API, когда вам понадобится более подробная информация. Хорошо документированный API невероятно полезен.