can't cut a release without release notes
This commit is contained in:
parent
1afa0d034b
commit
e54a83a28b
1 changed files with 54 additions and 0 deletions
54
docs/release-notes/marginalia-v0.8.0-release-notes.markdown
Normal file
54
docs/release-notes/marginalia-v0.8.0-release-notes.markdown
Normal file
|
@ -0,0 +1,54 @@
|
||||||
|
Marginalia v0.8.0 Release Notes
|
||||||
|
===============================
|
||||||
|
|
||||||
|
Marginalia is an ultra-lightweight literate programming tool for Clojure and ClojureScript inspired by [docco](http://jashkenas.github.com/docco/)*.
|
||||||
|
|
||||||
|
To get a quick look at what the output looks like, [visit the official Marginalia website](http://fogus.me/fun/marginalia/).
|
||||||
|
|
||||||
|
**Usage notes and examples are found on the [Marginalia Github page](http://github.com/gdeer81/marginalia).**
|
||||||
|
|
||||||
|
Places
|
||||||
|
------
|
||||||
|
|
||||||
|
* [Source code](https://github.com/gdeer81/marginalia)
|
||||||
|
* [Ticket system](https://github.com/gdeer81/marginalia/issues)
|
||||||
|
* [manifesto](http://blog.fogus.me/2011/01/05/the-marginalia-manifesto/)
|
||||||
|
|
||||||
|
Changes from v0.7.1
|
||||||
|
-------------------
|
||||||
|
|
||||||
|
### lein-marginalia
|
||||||
|
|
||||||
|
As always, the prefered way to use Marginalia to generate your documentation is via the [lein-marginalia](http://github.com/fogus/lein-marginalia) Leiningen plugin, like so:
|
||||||
|
|
||||||
|
:dev-dependencies [[lein-marginalia "0.8.0"]]
|
||||||
|
|
||||||
|
To run Marginalia, simply run `lein marg <options> <files>` in your project's directory.
|
||||||
|
|
||||||
|
### Multidoc Generation
|
||||||
|
|
||||||
|
Marginalia has long supported the generation of documentation where each namespace is contained in its own HTML file. This feature is finally exposed via the command-line/Lein interface and executed as `lein marg --multi <more options> <files>`.
|
||||||
|
|
||||||
|
### Bug fixes
|
||||||
|
|
||||||
|
* :url in project-info now creates a hyperlink for the project name
|
||||||
|
* Support for ClojureScript's data literals!
|
||||||
|
* Suppress comment parsing through [directives](https://github.com/gdeer81/marginalia/pull/126)
|
||||||
|
* Floating-toc HTML in generated uberdoc
|
||||||
|
* Sort files by namespace
|
||||||
|
* Improved handling of ClojureScript files
|
||||||
|
* Added support for .cljx file extension
|
||||||
|
* All of the documentation reflects the new library maintainer
|
||||||
|
|
||||||
|
Plans
|
||||||
|
-----
|
||||||
|
|
||||||
|
The following capabilities are under design, development, or consideration for future versions of Marginalia:
|
||||||
|
|
||||||
|
* Nicer looking `toc.html` generation in `--multi` mode output.
|
||||||
|
* protocol docstring support
|
||||||
|
* Explore the possibility of leveraging the [ClojureScript](http://github.com/clojure/clojurescript) analyzer.
|
||||||
|
* Explore the possibility of leveraging [sjacket](https://github.com/cgrand/sjacket)
|
||||||
|
* More documentation and examples
|
||||||
|
|
||||||
|
More planning is needed around capabilities not listed nor thought of.
|
Loading…
Reference in a new issue