Add datomic-snippets

[magnars]

A snippet package for Datomic. http://www.datomic.com/

I've reused the foundation for snippet packages we managed to hobble together last time. :)

[purcell]

I committed a modified version of this recipe which omits the README: we don't bundle non-.info documentation into packages.

Note that you're missing a dependency on the yasnippet package in the 2 .el files: should probably be (yasnippet "0.6.1").

[magnars]

Ok, I added the README since the Commentary-section mentions it. I'm so tired of keeping docs in two places.

I'll fix the yasnippet dependency. Thanks!

[purcell]

Apparently org-readme can be used to generate a github-ready README from the commentary.

In general, I think that the commentary section should contain just a brief package description and post-installation usage instructions, whereas the README should be broader and contain installation instructions and info about the project in general. So I think the 2 are complementary, rather than redundant.

[magnars]

Thanks. I'll move in that direction, then. But it does mean that you're not
bundling a full set of docs with the package.

On Tue, Jun 25, 2013 at 12:21 PM, Steve Purcell notifications@github.comwrote:

Apparently org-readme https://github.com/mlf176f2/org-readme can be
used to generate a github-ready README from the commentary.

In general, I think that the commentary section should contain just a
brief package description and post-installation usage instructions, whereas
the README should be broader and contain installation instructions and info
about the project in general. So I think the 2 are complementary, rather
than redundant.

—
Reply to this email directly or view it on GitHubhttps://github.com//pull/845#issuecomment-19966738
.

[purcell]

That's fine. Standard Emacs documentation is either commentary or texinfo, so we're explicitly not supporting anything else.

I wonder if there's something out there which converts markdown to texinfo...