This page is not created by, affiliated with, or supported by Slack Technologies, Inc.
2023-11-24
Channels
- # announcements (11)
- # babashka (11)
- # beginners (36)
- # biff (14)
- # cider (2)
- # clj-commons (9)
- # clojure (34)
- # clojure-czech (2)
- # clojure-europe (65)
- # clojure-nl (2)
- # clojure-norway (12)
- # clojure-uk (4)
- # clojuredesign-podcast (7)
- # clojurescript (5)
- # cursive (8)
- # deps-new (6)
- # hugsql (1)
- # humbleui (2)
- # hyperfiddle (5)
- # leiningen (21)
- # off-topic (2)
- # polylith (5)
- # practicalli (1)
- # releases (1)
- # sci (64)
- # sql (9)
- # squint (43)
- # test-check (6)
- # vim (7)
FYI I've added deps.edn support for metrics-clojure and took over this issue to prepare release https://github.com/clj-commons/metrics-clojure/issues/141 . IMO the first release should be just code migrated to clj-commons and deps.edn - no major code changes to metrics-clojure libraries
@seancorfield, @slipset: does clj-commons have a readthedocs account? Trying to publish docs for https://metrics-clojure.readthedocs.io/en/latest/# . We might use github pages but we should probably remove the project on read the docs. WDYT?
My preference would be for each project to have a docs
folder and rely on http://cljdoc.org for documentation. That said, Marginalia has docs that are rendered by marginalia
itself so they're pure HTML and I've hosted those on the gh-pages branch so they show up under http://clj-commons.org for now. I have no idea about http://readthedocs.io tho', sorry.
https://clj-commons.org/marginalia/ -> https://github.com/clj-commons/marginalia/tree/gh-pages
@eugen.stan, if they are plain old docs suitable for cljdoc, I can give you a hand with any conversion and config. Lemme know.
@seancorfield: metrics-clojure has docs in ReStructured Text format - generates html, pdf,epub with Sphinx python tool. I don't plan to rewrite any time soon, use as is. I will ping one of the authors to see if they can transfer the readthedocs account as well.
In the meantime, you could generate to HTML and put it on the gh-pages branch of the metrics-clojure repo, and then https://clj-commons.org/metrics-clojure/ will be the doc root?