While I appreciate the interest, I think that attempting to officiate
Grimoire is a bad move.
We already have clojure.org. clojure.org is the only official site.
Grimoire is not condoned by Rich. Using #clo?j.*\.org would detract
from any future documentation effort Rich and co. may make and
Well, clojure-grimoire.com is available, FWIW.
Tim
On Saturday, July 12, 2014 2:46:18 AM UTC-4, Reid McKenzie wrote:
While I appreciate the interest, I think that attempting to officiate
Grimoire is a bad move.
We already have clojure.org. clojure.org is the only official site.
Grimoire
On Tuesday, July 8, 2014 3:07:03 PM UTC-4, Reid McKenzie wrote:
1) doesn't make a whole lot of sense. I'm an adherent to the simplest
thing that could possibly work philosophy, and as a result Grimoire is
entirely static HTML. Search and symbol quick access could be implemented
by
I'd also love to see a custom domain for this as well. I'm happy to pay
for it if no one else will. How about clj-docs.org or clj-doc.org (which
are available)? I do see clojuredoc.org is available but could easily be
confused with clojuredocs.org
There's also clojure-doc.org.
--
Once Grimoire starts getting custom examples, we could provide a
corresponding client like clojuredocs-client that slurps
_includes/**/examples and strips text only between raw and endraw tags.
That would allow you to keep Grimoire as simple static HTML while still
allowing for painless
There's also a version of what you wrote (at least something very similar),
where one can specify libraries he wants docs for and have it all running
either locally or on some webserver: https://github.com/ifesdjeen/gizmo-cloc
Adds code snippets with highlights and lucene-backed search.
On
Mark, creating separate versions of the Clojure cheat sheet that link to
Grimoire instead of ClojureDocs.org should be fairly straightforward, but
due to other work I won't get to it for at least a few days. If someone
else is interested, and not put off by my code, they are welcome to go for
it
If we think that Grimoire should be the official ClojureDocs replacement,
why don't we do that? Could we just host Grimoire under the clojuredocs.org
domain, perhaps structuring the URLs to match?
One thing that I couldn't see - does Grimoire offer an API to get access to
the examples?
On 8
On Tue, Jul 8, 2014 at 3:28 AM, Colin Fleming colin.mailingl...@gmail.com
wrote:
If we think that Grimoire should be the official ClojureDocs replacement,
why don't we do that? Could we just host Grimoire under the
clojuredocs.org domain, perhaps structuring the URLs to match?
Depends upon
That was sort of a royal we, the community. I think everyone probably
agrees that it's not in anyone's interest to have two separate clojure doc
sites serving essentially exactly the same purpose (docs + examples). It
looks like Zachary is working fairly actively on his new ClojureDocs
version, is
1) doesn't make a whole lot of sense. I'm an adherent to the simplest
thing that could possibly work philosophy, and as a result Grimoire is
entirely static HTML. Search and symbol quick access could be
implemented by adding some javascript, but that's a low priority item at
the moment as there
Not as such. Strictly speaking one can navigate to say
https://github.com/arrdem/grimoire/edit/master/_includes/1.4.0/clojure.core/DASH/examples.md
and find all the examples for what is in this case clojure.core/-.
However there is no examples API at present and due to the flat file
nature of
Hey Reid,
Nice work! I think this is a much more maintainable approach for a
community-based examples repository. Have you thought about seeding
examples from clojuredocs using their api
e.g. http://api.clojuredocs.org/examples/1.3.0/clojure.core/map? I think
this would help if the goal is
I have, and I spent a little bit playing with extending my build script
to scrape their API, however it wasn't dead easy so I haven't thrown a
whole lot more time at it. An issue I'm running into is that the build
clojure program can't tell if there are examples for a given symbol and
clobbers the
I'm delighted to announce that thanks to the official Clojuredocs client
(https://github.com/dakrone/clojuredocs-client) Grimoire now features
every example posted on Clojuredocs.
Ex.
http://www.arrdem.com/grimoire/1.6.0/clojure.core/DASH__GT__GT/#example-0
Currently at 0.0.13, which represents
Nice work! I've been using Grimoire all day :)
Two small suggestions, which you have probably thought of: (1) search (2)
a copy of the clojure cheat sheet that points to grimoire instead. (Maybe
Grimoire needs it's own domain?)
CrossClj is *awesome* as well. I've been wanting something similar
Hey guys,
If you're like me while using clojure.repl/doc works for the most part
there are just times that you need to send someone a link to the
official docs and navigating the docstrings in the core Clojure
repository is a pain.
After several months of being frustrated that clojuredocs is out
Very nice work.
I've recently done something similar, by adding to http://crossclj.info the
ability to navigate auto-generated docs from docstrings and metadata.
The user interface balance is a bit different, the navigation is by
namespace or by project, for example:
What is the status of Clojuredocs? It has lots of good examples and Google
juice but is out of date. It would be great if we could update it to 1.6. I'd
be happy to help in whatever way is needed.
Is this possible/feasible?
Daniel.
On 2/07/2014, at 12:22 pm, Francesco Bellomi
Zachary Kim has mentioned in an issue comment that he might be able to find
time to update the source code and doc strings to Clojure 1.6.0, here:
https://github.com/zk/clojuredocs/issues/66
I don't know when/if that will happen.
Andy
On Tue, Jul 1, 2014 at 7:12 PM, Daniel Compton
20 matches
Mail list logo