doc-jit

1.5.0 • Public • Published

Doc-JIT

Just In Time documentation.

Introduction

Display the right documentation when you need it. Doc-JIT is an VS Code extension developers to open the most relevant documentation when coding features.

Getting started

There are 2 ways to use just in time documentation:

The configuration file

This is the recommended way if you already have a documentation.

Doc-JIT uses cosmiconfig for configuration file support. You can either configure with:

  1. A "doc-jit" key in your package.json file.
  2. A .doc-jitrc file written in JSON or YAML.
  3. A .doc-jitrc.json, .doc-jitrc.yml, .doc-jitrc.yaml, or .doc-jitrc.json5 file.
  4. A .doc-jitrc.js, .doc-jitrc.cjs, doc-jit.config.js, or doc-jit.config.cjs file that exports an object using module.exports.
  5. A .doc-jitrc.toml file.

The configuration file will be resolved starting from the location of the file being formatted, and searching up the file tree until a config file is (or isn’t) found.

Example:

{
  "patterns": {
    "**/modules/**/api/**/*.hook.ts": "https://link-to-fetching-api-documentation.io",
    "**/shared/utils/**": [
      "https://link-to-shared-module-documentation.io",
      "https://link-to-util-documentation.io"
    ]
  }
}

ℹ️ You can link to the same documentation for different patterns and you can label the resources:

{
  "patterns": {
    "**.test.ts, **.spec.ts": {
      "label": "Vitest documentation",
      "uri": "https://vitest.dev/"
    }
  }
}

The documentation .doc-jit directory

If you want to have the documentation close to the code, you can in a doc-jit directory and following these steps:

  1. Create a .doc-jit directory next to src,
  2. write your documentation based on your architecture,
  3. use wildcards __ when folders have specific names (eg: modules/__/components/component.md works for modules/user/component/ or modules/book/component/)

Demo


References

Icon created by Hilmy Abiyyu A. - Flaticon

Readme

Keywords

none

Package Sidebar

Install

npm i doc-jit

Weekly Downloads

0

Version

1.5.0

License

MIT

Unpacked Size

4.13 MB

Total Files

59

Last publish

Collaborators

  • julienc6