Skip to content
Permalink
Branch: master
Find file Copy path
1 contributor

Users who have contributed to this file

30 lines (16 sloc) 1.94 KB

cljdoc roadmap

Spec Integration

Integrating clojure.spec in some way could be very useful. With an appropriate storage and query layer we might even be able to provide Hoogle style navigation from a functions args and return specs to functions returning/accepting data in that shape.

See https://github.com/cljdoc/cljdoc/issues/67 for some further discussion/status.

Examples

Examples have proven very useful, in particular for documenting clojure.core on https://clojuredocs.org. cljdoc could also provide ways to attach examples to namespaces, individual vars etc. While challenging interactive examples are also an interesting angle to explore.

See https://github.com/cljdoc/cljdoc/issues/70 for some further discussion/status.

Documentation Highlights

Some namespaces, vars or articles might be more interesting than others because they are better documented, or just display the core functionality of a library. cljdoc could infer (or provide ways to configure) items that should be highlighted for users, allowing them to find relevant documentation quicker.

See https://github.com/cljdoc/cljdoc/issues/56 for some further discussion/status.

New Storage Backend

cljdoc currently uses Grimoire for storage which has been designed to store metadata on namespaces and vars. While this has been extremely useful in the beginning it is now somewhat limiting when it comes to implementing features like the aforementioned clojure.spec integration, examples and more.

Likely this issue will need to be tackled before those features can be built. The storage layer has already been refactored into a protocol so swapping it with something new should be possible without touching code in lots of places.


All of the above issues and perhaps more are tagged with the Hammock label.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.