Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Feature Request : Expand Documentation Details #34

Open
rohitmore07 opened this issue Nov 3, 2024 · 0 comments
Open

Feature Request : Expand Documentation Details #34

rohitmore07 opened this issue Nov 3, 2024 · 0 comments

Comments

@rohitmore07
Copy link

rohitmore07 commented Nov 3, 2024

Description : The current documentation for Komapper provides a general introduction, a quickstart guide, a few code examples and a reference section. However, it can be further expanded to provide a more detailed and comprehensive understanding of the library.

The following areas can be improved:

  • Overview :
    Provide a more in-depth explanation of Komapper's core concepts, its benefits over other Kotlin ORMs and why developers should choose Komapper. A comparison with other popular ORMs (like Exposed or Hibernate) would be helpful.
  • Quickstart :
    Expand this section to include a full end-to-end tutorial. This could cover setting up a project, configuring the database and performing basic CRUD operations using Komapper. Including sample configuration files and detailed explanations would be beneficial.
  • Examples :
    Add more practical examples for common use cases like complex queries, handling relationships between entities, pagination and using advanced features like custom queries or transaction management. Each example should come with a brief explanation of how it works and its use case.
  • Reference :
    The reference section could be expanded with more detailed descriptions of Komapper’s features, including:
    • Query expressions and operators : A deeper explanation of each operator, how and when to use them and common
      patterns.
    • Database configurations : A comprehensive list of all supported database types, configuration settings and
      troubleshooting tips.
    • Advanced usage : Information about integrating Komapper with other libraries or frameworks, performance tuning,
      and optimizing database queries.
@rohitmore07 rohitmore07 changed the title Improve navigation bar of komapper website Feature Request : Expand Documentation Details Nov 6, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant