dexie/Dexie.js

Improve docs of DBCore

Open

#1,032 opened on May 4, 2020

View on GitHub
 (0 comments) (0 reactions) (0 assignees)JavaScript (625 forks)batch import
doc improvementsgood first issue

Repository metrics

Stars
 (10,304 stars)
PR merge metrics
 (Avg merge 2d 5h) (3 merged PRs in 30d)

Description

Need help providing more samples and better flow documentation of the DBCore interface and all its methods and related interfaces. For a skilled developer, it is possible to lab with DBCore even based on the minimal docs we have now, by looking at existing middlewares and create a custom middleware.

There is a skelleton of docs around the DBCore interface right now that is not very easy to follow. It would be a great help for others if someone had the time to provide more samples. My wish would be to provide the docs with some samples of middlewares and link to the samples from the docs of DBCore, Dexie.use() and DBCoreTable.

Related issue in dexiejs-web: https://github.com/dfahlander/dexie.js-web/issues/59

Contributor guide

Research direction
Examine existing DBCore documentation and example middlewares, then improve docs by adding more samples and step by step flow explanations for DBCore interface and related types.
Tech stack
javascript
Domain
database
Issue type
Documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
GitJavaScript
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
80