Impossible Mission: let's build the "openAPI online almanach".

Hi all,

I stopped working on plugins for a year, and now I'm back to square one,
with all those stupid little questions I don't dare asking: how to open
a class in an editor when all I know is the FQ, how to find the type of
a file, etc.... That's frustrating.
Between "reverse-engineer the existing plugins" and "read this book"
there must be a simple, fun, and effective solution.

Here it is: look no further than the
Java Developers Almanac-online
http://javaalmanac.com

Try a few terms: file, xml, image, preference, etc...
Brilliant, isn't it?

- The format is ideal : 10-20 lines of code at most, to answer simply
simple and specific questions.
- When the subject is more complex, a general
"The Quintessential xxxx Program"
page sets the general context. Smaller and more specific tips can then
refer to it, and offer their own solution in a few lines.
- Most pages contain a handful of links to the related solutions.

This could be built progressively by the community, and would be useful
from day 1.
Obviously, it's a wiki, but not intellij.org: we want search result to
only return openAPI answers. We also want an optimized format.

What to do:
-


step 1:
-


JetBrains:
- set up a new and clean wiki.
- fill it up with a dozen entries, to give a model, and tune the L&F
and formatting.


step 2:
-


Community-beginners: askers
- collect questions, on a page

Community-intermediate: editors
- edit the above page by subjects, reformat the question
- edit the whole KB formatting, fix broken links, add missing links, etc..
- tag obsolete pages (when the openAPI changes)

Community-advanced: givers
- answer to questions, from the list.


Alain

PS: I called it "Impossible Mission" because eventually, they always
succeed before the end of the episode :)

14 comments

You're right.

By the way, the book about IDEA is comming: http://www.livejournal.com/community/ideabook/
It has a big chapter about plugin development :)

Let's studing Russian ;)

0

Stanislav

>Let's studing Russian ;)

>

Or have a lot of fun with BabelFish :)

Alain

0

BabilFish not quite sure about Dave :)

0

Hello Alain,

AR> PS: I called it "Impossible Mission" because eventually, they always
AR> succeed before the end of the episode :)

Can you make a review of this http://www.intellij.org/twiki/bin/view/Main/PluginDevelopmentHowTo
?

Thanks!
--
Alexey Efimov, Java Developer
Tops BI
http://www.topsbi.ru

0

Alexey


> Can you make a review of this
http://www.intellij.org/twiki/bin/view/Main/PluginDevelopmentHowTo ?

Thanks for doing it; it looks useful, and simple enough for people to
use it, and really benefit from it.


A few remarks:
- The main form should let us start a search (1 field + 1 button).
- The search results should only contain entries that were entered
through your system.

- we need a way to associate multiple keywords to an entry:
configuration, Psi, Document, etc...
and
- we need a way to sort and/or filters the list of entries by/on 1 keyword.

I could say more, but I would just describe the original online Almanac.
Thanks again.

Alain


PS: JetBrains should accept the challenge, and build one with Fabrique.
It could be the very first public "Powered by Fabrique" application.


0

Hello,

I'm can't make search, becouse of TWiki limitation in this release.

- we need a way to associate multiple keywords to an entry:

configuration, Psi, Document, etc...
Done

- we need a way to sort and/or filters the list of entries by/on 1 keyword.


Done by using Table plugin in TWiki

0

The real problem is that plugin development is not taken as seriously on the Intellij platform as it is on the Eclipse platform. In Eclipse you can go to New Project... and choose essentially any type of possible plugin and it will generate you a project with a working version that you can simply edit and customize for your application. Its unbelievable that I can't find any simple documentation on how to add a new type of file that needs to be compiled during the build for instance. All I want to do is add a simple build step that compiles any out of date .groovy files to the same place that the .java files are compiled to. This seems to be way too difficult in Intellij from a documentation point of view. Please, Intellij devs, look at Eclipse for a proper plugin development paradigm and enough with the random ant scripts with no docs or the Look at this plugin to see how it works type links. This is not the way to create a huge community of plugin developers no matter how much better your product might be. I really like Intellij but the lack of simple extension drives me crazy and forces me to look to eclipse to build my own plugins for IDEs.

0

Are you already try DevKit?

TIA,
Dmitry

0

I downloaded the DevKit and it didn't appear to have any documentation with it. How do you install it? How do you use it? Why aren't there projects for the examples that are in the DevKit that I can load and build and install?

Do you see what I mean? You basically are asking people to feel around in the dark to get a look at the API rather than just spelling it out clearly. You must be building your own plugins in Intellij, where are those projects that we can load up and look at? Where is the plugin.xml editor that isn't just a plain XML file but instead is a property sheet in Intellij so all the options are clearly laid out? Why all this mystery?

I will help you make something that is clear if your intention is to provide something that is compelling to the general development community and not just those people who want to be IntelliJ plugin experts.

0

To add to that, Where is the Hello, world! tutorial for building plugins?

0

I'd agree 100%. I spent a day or two fishing around for answers on IDEA plugins and just gave up. I should have been able to write the entire plugin in that amount of time.

I was talking to someone tonight who explained that building a plugin for Eclipse was trivial because it walks you through the gritty parts. It probably explains why there are a lot more plugins out for Eclipse. I'm aware that many of them aren't that great, but that just attests to how easy it is to create them if you ask me.

0

Hello Sam,

SP> To add to that, Where is the Hello, world! tutorial for building
SP> plugins?

Peoples, who want to write plugin usualy know how to write Hello World aready.
Isn't it? :)
The samples here:
http://www.intellij.org/twiki/bin/view/Main/PluginDevelopmentSamples

Thanks!
--
Alexey Efimov, Java Developer
Tops BI
http://www.topsbi.ru

0

This is actually much more helpful than any of the other things I have seen. I urge you though to look at the way Eclipse does this particular thing. It is amazing how easy it is to produce plugins for that platform in comparison.

0

Hello Sam,

SP> This is actually much more helpful than any of the other things I
SP> have seen. I urge you though to look at the way Eclipse does this
SP> particular thing. It is amazing how easy it is to produce plugins
SP> for that platform in comparison.

Can you give me link to this Eclipse tutorial?

Thanks!
--
Alexey Efimov, Java Developer
Tops BI
http://www.topsbi.ru

0

Please sign in to leave a comment.