new article for jit documentation
This commit is contained in:
1
components.d.ts
vendored
1
components.d.ts
vendored
@@ -14,7 +14,6 @@ declare module '@vue/runtime-core' {
|
|||||||
CrcProject: typeof import('./src/components/architecture/crc-project.vue')['default']
|
CrcProject: typeof import('./src/components/architecture/crc-project.vue')['default']
|
||||||
ForgettingCurve: typeof import('./src/components/smart-notes/forgetting-curve.vue')['default']
|
ForgettingCurve: typeof import('./src/components/smart-notes/forgetting-curve.vue')['default']
|
||||||
FormInput: typeof import('./src/components/design-system/form/FormInput.vue')['default']
|
FormInput: typeof import('./src/components/design-system/form/FormInput.vue')['default']
|
||||||
Island: typeof import('./node_modules/.pnpm/iles@0.9.5_rollup@2.79.1_sass@1.62.1/node_modules/iles/dist/client/app/components/Island.vue')['default']
|
|
||||||
JulienCalixte: typeof import('./src/components/core/julien-calixte.vue')['default']
|
JulienCalixte: typeof import('./src/components/core/julien-calixte.vue')['default']
|
||||||
MyProjects: typeof import('./src/components/presentation/my-projects.vue')['default']
|
MyProjects: typeof import('./src/components/presentation/my-projects.vue')['default']
|
||||||
OrderTag: typeof import('./src/components/core/order-tag.vue')['default']
|
OrderTag: typeof import('./src/components/core/order-tag.vue')['default']
|
||||||
|
|||||||
63
src/pages/posts/just-in-time-documentation.mdx
Normal file
63
src/pages/posts/just-in-time-documentation.mdx
Normal file
@@ -0,0 +1,63 @@
|
|||||||
|
---
|
||||||
|
title: Just in time documentation is the right documentation
|
||||||
|
illustration: https://cdn.jsdelivr.net/gh/jcalixte/static@master/doc-jit/doc-jit-cover.png
|
||||||
|
layout: post
|
||||||
|
date: 2023-05-29
|
||||||
|
---
|
||||||
|
|
||||||
|
# Just in time documentation is the right documentation
|
||||||
|
|
||||||
|
## Falling over the same trap again and again
|
||||||
|
|
||||||
|
Many times a problem occurs where new developers fall over the same trap again and again despite the fact that the solution has been well documented. How can it be their fault? They didn't even know the documentation existed!
|
||||||
|
|
||||||
|
The eternal question of "do we write documentation for our project?"... But if no one read it when it needs to, the documentation becomes waste.
|
||||||
|
|
||||||
|
## Just in time
|
||||||
|
|
||||||
|
_Just in time_ (`jit`) is a lean concept: the goal for a team is to produce the right amount of value when the client needs it. No less no more.
|
||||||
|
|
||||||
|
So I created a VS Code extension doing exactly that: [doc-jit](https://marketplace.visualstudio.com/items?itemName=jcalixte.doc-jit). It provides the right amount of knowledge the exact moment the developper needs it: _just in time documentation_. 🤎
|
||||||
|
|
||||||
|
## How does it work?
|
||||||
|
|
||||||
|
You set glob patterns that is affiliated with a documentation file and [doc-jit](https://marketplace.visualstudio.com/items?itemName=jcalixte.doc-jit) will propose you when your active file matches at least one of them.
|
||||||
|
|
||||||
|
```json
|
||||||
|
// .doc-jitrc.json
|
||||||
|
{
|
||||||
|
"patterns": {
|
||||||
|
"**/*.test.ts, **/*.test.tsx": [
|
||||||
|
{
|
||||||
|
"label": "Jest documentation",
|
||||||
|
"uri": "https://jestjs.io/docs/getting-started"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"label": "Vitest documentation",
|
||||||
|
"uri": "https://vitest.dev/guide/"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"**/*.test.tsx": [
|
||||||
|
{
|
||||||
|
"label": "React Native testing library documentation",
|
||||||
|
"uri": "https://callstack.github.io/react-native-testing-library/docs/getting-started"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
In real life, it looks like this:
|
||||||
|
|
||||||
|
<video controls autoplay loop preload="none" playsinline muted>
|
||||||
|
<source
|
||||||
|
src="https://cdn.jsdelivr.net/gh/jcalixte/static@main/doc-jit/docjit-tuto.webm"
|
||||||
|
type="video/webm"
|
||||||
|
/>
|
||||||
|
<source
|
||||||
|
src="https://cdn.jsdelivr.net/gh/jcalixte/static@main/doc-jit/docjit-tuto.mp4"
|
||||||
|
type="video/mp4"
|
||||||
|
/>
|
||||||
|
</video>
|
||||||
|
|
||||||
|
It's that simple and you can start with ease. For example, just your dependencies first, it's surprisingly powerful. Then add your own documentation, standards, tutorial, videos, etc. One problem solving at a time. Just in time. 😊
|
||||||
Reference in New Issue
Block a user