Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 8 years ago.
Improve this question
I've recently started using Rhino Mocks and don't have a full understanding of its contexts, states and features, sometimes mistakenly comparing it too closely to other mocking frameworks. For example, the following sentence talks about a replay state and that threw me for a bit:
A call to <Rhino.Mocks.MockRepository.ReplayAll> would move the mock
object(s) to replay state, a call to <Rhino.Mocks.MockRepository.VerifyAll>
is made from the [TearDown] method.
Can anybody point me to high level conceptual explanations online (technical would be best) of the various states, nuances and understandings needed to wield this tool well, (e.g. so I don't waste time forgetting to call .ReplayAll() and also so I know why I have to use replay).
The online documentation that I've seen seems to jump right into it. Am I missing a major piece of documentation, or must I skim online blogs and such, or buy a book to get the kind of high level conceptual intro that I'm asking for?
Not sure if this is what you're looking for, but this is the documentation for Rhino Mocks that I can never find when I need it:
http://ayende.com/wiki/Rhino+Mocks+3.5.ashx
Related
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 5 years ago.
Improve this question
Background
There is a hardware project going on. A hardware accelerator has been being developed by a team of students but there is no general documentation.
There are READMEs here and there, some docxs and in-code (Verilog, C and Lua) comments, but nothing else. The code is written with Vim, versioned with Git and Markdown is our friend, even if we are not on Github (yet).
Since this “thing” is growing, I feel the necessity of writing down something (user manual? developer notes?) but I don't know where to start.
Question
When someone feels the urge of documenting his project, where does it start?
More specifically, what are the generally accepted criteria to do it and what are the best tools?
My hypothetical answer
We quite clearly need both a developer and user manual. One with details of the algorithmic solutions, the other... like for monkeys.
About the tools, I believe that something like a Github Wiki would work fine, but (1) we are not on Github and (2) wouldn't be LaTeX a better way of writing stuff in order to publicise it, eventually. I know we can get our Markdown rendered in a printable way with http://www.cocowrite.com/, but is it the most efficient solution? LaTeX would be a nuisance for collaborative editing and online HTML publishing.
A partial answer can be found here: “What tools are used to write documentation?”.
Second part of the answer can be found here: “What amount of documentation is needed for a non-trivial one-man software project”
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 5 years ago.
Improve this question
I know Norman is working on the Netty 4 book as I've been following the tweets, but was wondering if there are any pieces available to help someone who hasn't worked with Netty 3. I have looked a little at the existing 3.x articles, but I think it would be easier to understand the primary components without having to learn 3.x and then mentally apply the New and Noteworthy section to bridge the gap.
For now, I'm just trying to go through the example/test code to see how it's used, but any overview/fundemental documentation would be great. If not, that's ok - just thought I'd check.
Thanks
There is nothing out there at the moment except what you find on the Blog and the javadocs. I'm currently working hard on getting the javadocs up-to-date before our next release, so you may find all you need in there. An other source of informations is like you said the example module which contains a lot examples for all kind of use-cases.
Hopefully the MEAP of the Netty book will start in not so far future. But we will see..
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 5 years ago.
Improve this question
I learned how to find out which version of ClojureScript I'm using with lein-cljsbuild. Where can I find API documentation for cljs.core?
I had to find out about js-obj from a blog post.
I can look at the source code, but it's a large file and it's mostly clojure.core stuff.
Not exactly thorough documentation, but this cheat sheet is really quite helpful when starting out (and better than nothing!):
http://appletree.or.kr/quick_reference_cards/Others/ClojureScript%20Cheat%20Sheet.pdf
ClojureScript definitely has a documentation problem. You're actually not too bad off looking at the source; it's verbose but not too bad once you get used to it.
That said, one of the reasons nobody has produced a definitive ClojureScript API reference is that the core functions all mirror Clojure, so it would be quite a lot of redundant effort. If a function exists in both languages and doesn't work the same way, it's highly unusual and quite possibly a bug.
In practice, I find that using the Clojure API docs (or something like clojuredocs.org) coupled with very occasional forays into the source code work pretty well for 99% of my cljs work.
ClojureScript API Documentation is being worked on here:
http://cljs.github.io/api
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 5 years ago.
Improve this question
Are the JavaDocs for clojure.lang, etc. available online? Do I need to build it myself from the Clojure source?
Thanks.
if you want descriptions for functions and even examples, visit ClojureDocs
you can even contribute ;)
Javadocs don't exist, per se. If you look at the Java source code, it's very sparsely documented. Certainly you could generate a skeleton yourself, but it probably wouldn't be all that useful anyway as much of the language is self-implemented (in clojure), using Java mostly for bootstrapping the core functionality. I don't think clojure.lang package is really intended to be used directly.
To learn about Clojure functions you can:
Use (doc) and (find-doc) from a repl
Use the API reference at clojure.org
See ClojureDocs, per #Belun's answer
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 7 years ago.
Improve this question
I'm looking for a good open source multi-touch API to use in a project we might get. So far I've found PyMT, but haven't really seen any comments on the maturity of that product, so any input in that regard would be much appreciated.
I'd also like some other suggestions on API's that might be of interest, since googling have only given so much, and as with PyMT, it is quite difficult finding opinions on the frameworks out there.
Many thanks.
Have you looked at IDEO and touchkit?
I specially like MT4J, its a multitouch java API, it has good code examples so it's easy to start with it.
http://www.mt4j.org/mediawiki/index.php/Main_Page
Many of these libraries ( if not all) are based on TUIO protocol (an open framework that defines a common protocol and API for tangible multitouch surfaces)
I would recommend you to go to their official page where you will find the libraries and clients based on TUIO protocol for many languages.
I think PyMT is better than MT4J.