_ _ _
__| / / |_ __
/ _` | | | '_ \
| (_| | | | | | |
\__,_|_|_|_| |_|
d11n - dx spec implementation experiment
| this is an experiment that may or may not
| become a successor to documentation.js. i want to build
| a successor to documentation.js, because i think jsdoc's
| time has passed, the documentation.js approach is
| complex in certain irreducible ways, and that hosted documentation
| and dynamic documentation (autocomplete-based) should be
| solved.
the ideas so far are:
- let javascript itself define hierarchy and type
- prioritize runtime documentation access
- simplify, simplify, simply
- be opinionated when it helps us simplify
- host early
deal with later:
- documentation format. let's just get basic comments working first.
--------------------------------------------------------------------------------
_______
| ___ o|
|[_-_]_ |
______________ |[_____]|
|.------------.| |[_____]|
|| || |[====o]|
|| || |[_.--_]|
|| || |[_____]|
|| || | :|
||____________|| | :|
.==.|"" ...... |.==.| :|
|::| '-.________.-' |::|| :|
|''| (__________)-.|''||______:|
`""`_.............._\""`______
/:::::::::::'':::\`;'-.-. `\
/::=========.:.-::"\ \ \--\ \
\`""""""""""""""""`/ \ \__) \
jgs `""""""""""""""""` '========'
--------------------------------------------------------------------------------
how it works so far:
1. uses rollup to start with an entry point and
traverse dependencies
2. uses a transform to associate comments with objects
in an exported map
3. traverses the exported surface of the module to
produce static documentation
--------------------------------------------------------------------------------
speculative future:
- proposal-import-meta may provide a way forward
to standardize the way that this information is
passed around
- runtime access ideally relies on a runtime
transformation, which is tbd
--------------------------------------------------------------------------------
non-goals:
- i don't think that i want to support babel
anymore. it was fun for a while, but the infinite
configurations weigh heavily one me, and on
node_modules. i want something with near-zero
configuration that can be shared by as many people as
possible.
d11n
0.0.1-0 • Public • PublishedPackage Sidebar
Install
npm i d11n
Weekly Downloads
3
Version
0.0.1-0
License
MIT
Unpacked Size
61 kB
Total Files
10