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

core: universal-box doc-db command #164

Open
Abhishek-Mallick opened this issue Oct 20, 2024 · 1 comment
Open

core: universal-box doc-db command #164

Abhishek-Mallick opened this issue Oct 20, 2024 · 1 comment
Assignees
Labels
enhancement New feature or request hacktoberfest marks issues which are accepted under hacktoberfest 🤔Needs discussion Open to further discussions

Comments

@Abhishek-Mallick
Copy link
Owner

Is your feature request related to a problem you're trying to solve with Universal-Box? Please describe.
This issue aims to address the need for comprehensive documentation for various databases within the Universal-Box project. Currently, users may find it challenging to understand how to integrate and utilize different databases effectively in their projects. By automating the documentation process, we can provide clear and accessible information.

Describe the solution you'd like
I propose creating a command-line tool that generates markdown documentation for popular database schemas. The initial focus will be on Prisma, but the tool should be designed generically to accommodate other databases as well. The tool will read the database schema files, parse the models and enums, and output a markdown file documenting the schema.

Expected Features:

  • Prisma Integration: Generate markdown documentation from Prisma schema files.
  • Generic Database Support: Extend functionality to support other popular databases such as:
    • MySQL
    • PostgreSQL
    • MongoDB
    • SQLite
    • Microsoft SQL Server

Describe alternatives you've considered
An alternative approach could be to manually document each database schema in markdown files. However, this would be time-consuming and prone to inconsistencies. Automating this process will ensure that documentation is always up-to-date with the latest schema changes.

How would this feature improve Universal-Box?
Implementing this feature will enhance the usability of Universal-Box by providing users with clear and concise documentation for integrating various databases into their projects. This will streamline the onboarding process for new users and reduce confusion around database configurations.

Additional context
The generated markdown files should include:

  • Overview of each database model
  • Field descriptions and data types
  • Relationships between models (if applicable)
  • Example queries or usage scenarios
@Abhishek-Mallick Abhishek-Mallick added the enhancement New feature or request label Oct 20, 2024
@Abhishek-Mallick
Copy link
Owner Author

I am currently working on this issue .. starting off with Prisma .. anyone who wants to join along to add logic for extended support for other databases feel free to reach out to me on Discord

@Abhishek-Mallick Abhishek-Mallick added hacktoberfest marks issues which are accepted under hacktoberfest 🤔Needs discussion Open to further discussions labels Oct 20, 2024
@Abhishek-Mallick Abhishek-Mallick self-assigned this Oct 20, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request hacktoberfest marks issues which are accepted under hacktoberfest 🤔Needs discussion Open to further discussions
Projects
None yet
Development

No branches or pull requests

1 participant