Writing documentation - open source solutions for displaying docs online? [closed] - actionscript-3

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've been working on a framework in AS3 that I want to release, but first I obviously need to prepare some documentation for it.
I've noticed that quite a few sites have the exact same layout, functionality etc as Adobe Livedocs, which has let me to believe that there's something open source out there for creating online documentation.
Here's some examples:
http://livedocs.adobe.com/flash/9.0/ActionScriptLangRefV3/
http://papervision3d.googlecode.com/svn/trunk/as3/trunk/docs/index.html
http://www.fisixengine.com/api/
Would anyone be able to point me in the right direction for tools that I can use to prepare online documentation?
Ideally the system would be specifically suited for documentation in ActionScript 3. I don't have a requirement in terms of the documentation being automatically generated either - if there's something out there that looks/works nice I'm happy to manually create the documentation (provided it comes with tools for easily adding classes, arguments, etc).

Adobe has a free tool called ASDoc. It generates documentation which follows the official Adobe patter. Frankly, it isn't worth it though. The ASDoc tool is buggy and unreliable. If it has difficulty finding an import, if an import isn't used, a comment is not correctly formatted, or you have your source code spread out in any sort of unexpected way, it simply breaks.
My company has lost over 50 developer hours (a few people tried to get a couple of different projects to work and failed) in an attempt to get around these limitations and our solution? We used NaturalDocs (A JavaDoc compiler). Is it perfect? No. Is it comparable to ASDoc in output? Sort of, it isn't as neat, and it would be nice if it treated things a little differently, but it works to display the documentation.

Related

are there any alternatives to yUML [closed]

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'm looking for an alternatives to yUML, preferably open source.
Sure yUML is great and I really like it, but I would like to be able to extend it.
I'm also interested in other services in the same direction (diagram generation), but I'm not looking for any (UML)desktop tools.
Some suggestions of textual modeling tools. For instance, take a look at PlantUML
Scruffy can draw some yUML diagrams.
Scruffy-Server is a newly made web server frontend for Scruffy which has a rendering and syntax almost identical to yUML.
At the moment it doesn't have the PDF/Json/SVG(or PS) export options, but those might be coming. On the other hand it is very fast and has a lean interface.
PS: I might a little be biased as I made it.
Perhaps take a look at jsUML2. It doesn't provide a textual syntax for specifying diagram - it provides a js-based api instead. However the api is very easy to use and it's open source so extensible. They have a demo app built using it here.
hth.
Some years ago I've developed an open source alternative based on Graphviz.
It's basic and only work for relationship diagrams, but it can be extended.
The output look is very similar to yUML.
Here's the link: http://web.fi.uba.ar/~ssantisi/works/glumly/

Tool for building intelligent agent? [closed]

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
Suggest me any open source based platform/IDE/framework/toolkit for developing intelligent agent. I don't have any background in this area, would like to use a tool or any tutorial in building intelligent agent.
If you don't have any background at all, I suggest you start with something simple.
I had quite a good experience with dmangame, a simple Python engine where you can script the behaviour of agents.
The good point is that the installation is very simple, you know where to code your Python scripts for AI, there is a nice API for it. And you've got a nice graphical interface to see directly what you code.
Edit : By the way, look at this similar question
Weka is probably the most comprehensive open source AI toolkit. It's positioned as a tool for "data mining" but don't let that put you of - it's a general toolset for machine learning which is exactly what you need if you want to build an intelligent agent.
You can use any IDE you like with it (it's Java based so that gives you a range of great open source IDEs such as Eclipse or Netbeans, but you can also call the Weka libraries from other languages if you like).
It also has some of its own tools build it (for visualisation and exploring data sets etc.)

Looking for a particular Common Lisp implementation [closed]

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'm looking for a Common Lisp implementation I ran across once, sometime in the past year or two. I only remember a few things, and I don't know how to search for it based on these facts, so maybe somebody here can help.
it was open-source, but wasn't one of the big ones (SBCL, CMUCL, MCL, etc.)
it was likely incomplete; it looked almost more like an exercise in writing the simplest possible self-hosted Common Lisp
the main webpage was plain black-on-white, and had 2 columns, where the left column was a link to the source file for a particular area of functionality (loop, format, clos, etc.), and the right column was a link to the tests for that functionality
the source files themselves were pretty-printed for the web, with syntax highlighting that looked kind of like an old Redhat Emacs default config: slate-gray background, etc.
Where can I find this Lisp implementation?
Thanks!
I don't know which one you are referring too, but you can find a list of Common Lisp Implementations here.
Is there any particular reason why this Lisp is grabbing your attention now?
Its hard to pin down, but open-source + minimalistic + incomplete sounds vaugely similar to Paul Graham's Arc programming language.

What would you recommend as an easily modifiable forum package? [closed]

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 in the process of setting up a new website which would greatly benefit from having user-forums.
Since I already have user accounts, and profile details, stored away it seems that I'd benefit from choosing an open-source forum package which I could modify so that logins were tested against my existing database.
Right now all my site is Perl-based, and looking around I don't see many great Perl forums - the only obvious one I could find which is featureful is yabb - but that is written to authenticate against flat files and to be frank the code is nasty.
If I need to use a PHP solution then so be it, but first are there any simple forums that are written in perl that you'd suggest? I'd expect to have different forum-groups and nominate particular users as moderators. More than that I don't need, just basic threading and an attractive appearance.
Really simple forums are often really insecure forums. If you're determined to use perl, a major web forum doesn't come to mind, and if your competent in security I'd say roll your own. You could even release it to the open source community to help people like you. I know there are several great PHP ones out there that aren't so insecure an rather well developed.
I seem to remember that Drupal had a reasonable fit as a module.

Source code of big/popular websites [closed]

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
It's great to find all those little snippets of code on the Web for your current needs, but is there anything better than getting whole application source code at once and reading it like a book?
There's no better way to learn positive and negative aspects of various architecture solutions.
That's why I was trying to find some known/big websites with its source code published, but haven't found anything more than I knew already ( http://code.reddit.com/browser )
Do you know anything more?
PS. Just being curious - have you heard about any unofficial big web site source code leak?
Wikipedia's source code (MediaWiki) can be found at http://www.mediawiki.org/
The most relevant parts are
"phase3" (the core code; this strange name is because it was rewritten a couple of times)
extensions (Wikipedia uses several of them; which ones can be seen at Special:Version)
Additionally, here is a very detailed explanation of Wikipedia's whole architecture: Wikipedia: Site internals, configuration, code examples and management issues.
You can check out SlashCode, which is the code behind Slashdot and any other sites that use that as a CMS / blogging solution. http://www.slashcode.com
Browsing through the SourceForge repositories is just what you want.
There are tons of well-known, high-quality applications, like Hibernate to give one massive example.
And all the source code is right there :)
http://www.koders.com/
HTH
Check out Rob Conery's screencast series, MVC Storefront, where he builds a small commerce website using ASP.NET MVC.