Don't get me wrong. The karaf examples are great and do a good job in showing all the features karaf has. The big issue though is that the examples show a lot of ways of doing the same thing. This is the right choice when it is about showing the features of karaf. It is not good as an introduction for how to create a streamlined application as it offers too many choices.
What I have in mind is a very opinionated and structured documentation that concentrates on one solution for each of the parts of an application. It also has to show how it all fits together. This is very different from the goals of the karaf examples. I remember well the discussion we had about the karaf examples and about how opinionated they should be. I think you were right about being not very opinionated for karaf examples. It fits the idea of the platform. Christian Am Do., 19. Sept. 2019 um 15:43 Uhr schrieb Julian Feinauer < j.feina...@pragmaticminds.de>: > Thanks Christian, I will check out your stuff later on. Ideally I would > love to have a book about karaf and some osgi basics and ds... But I guess > that's a lot of work. > > So I think tutorials and examples are a good pragmatic compromise : ) > ________________________________ > From: Jean-Baptiste Onofré <j...@nanthrax.net> > Sent: Thursday, September 19, 2019 8:15:08 AM > To: dev@karaf.apache.org <dev@karaf.apache.org> > Subject: Re: Hello World! > > Hi Christian, > > I think Karaf examples are good enough to start. They are maybe too > simple but provide "classic" use cases (rest, service, jpa, etc). > > I agree we can do more, and we are working on it. It's something I > discuss with some guys at ApacheCon last week. > I will come with concrete proposal soon ;) > > Regards > JB > > > On 19/09/2019 15:02, Christian Schneider wrote: > > The problem with OSGi docs is that most of the material is quite old. > > Much of it does not apply to modern OSGi development anymore. > > > > Another issue is that especially for dependency injection there are > quite a > > few alternatives. Every of these come with their own pros and cons. > > As a beginner it is difficult to understand and decide how to start. > > > > Karaf is a great way to start playing with OSGi as many things are > readily > > available and the shell and webconsole allow some nice insight into the > > system. What karaf does not provide though is a good introduction into > > OSGi. I tried to do so with my tutorials but they are more like explained > > examples. > > > > I planned to do a longer introduction around how to build a typical > > application based on best practices .. but it is a lot of work and I > never > > really took on the task. > > > > You might be interested in my recent talk about OSGi best practices. > > Unfortunately in 30 minutes I was not able to really explain how to build > > an application but maybe the example helps a bit. > > https://adapt.to/2019/en/schedule/osgi-best-practices.html > > The most interesting part there is maybe how to build bundles without xml > > config. > > The new annotations that combine requirements and configs are also very > > interesting. > > Both of these are not yet covered by much material on the web. > > In the example there is a small application with an angular front end > and a > > jax-rs backend that can be easily installed in karaf. > > > > Christian > > > > > > Am Mi., 18. Sept. 2019 um 06:45 Uhr schrieb Julian Feinauer < > > j.feina...@pragmaticminds.de>: > > > >> Hi, > >> > >> it was not so much karaf (I kind of liked it from the start) it was > rather > >> OSGi. > >> We come from spring and when I looked through all the osgi material lots > >> of it seemed strange and confusing like Aries, Blueprint, DS, enRoute, > ... . > >> Serge helped me a lot with sorting the things in my head and getting all > >> clear (also with bundle vs. feature vs. feature-repo) and DS stuff and > lots > >> more. > >> So I think Karaf is already doing an excellent job its rather the OSGi > >> world that is damn confusing and one thing that probably could help is a > >> small OSGi introduction or something. > >> > >> I hope that helps! > >> Julian > >> > >> Am 16.09.19, 11:47 schrieb "Jean-Baptiste Onofré" <j...@nanthrax.net>: > >> > >> By the way, Julian, I'm curious. Why did you consider Karaf "hard > for > >> you to adopt" ? It's to understand what we can improve (maybe > >> message/website, example, whatever) in the project to change that ! > >> > >> Thanks ! > >> Regards > >> JB > >> > >> On 16/09/2019 18:21, Julian Feinauer wrote: > >> > Hi everybody, > >> > > >> > my name is Julian and as I’m new on this list, I just wanted to > >> shortly introduce myself. I’m a contributor to some Apache projects > (PLC4X, > >> IoTDB, Calcite) and I met some karaf folks at the ApacheCon in Las > Vegas (I > >> was the guy hanging around introducing JB and Serge). > >> > I have Karaf on my radar for quite some time but always considered > >> it to hard for us to adopt. > >> > > >> > But, as Serge gave me an awesome hands on introduction yesterday, > I > >> feel like we should really start to work with it and see how it goes. > So, > >> expect some mails from me here or on user@. > >> > > >> > Best > >> > Julian > >> > > >> > >> -- > >> Jean-Baptiste Onofré > >> jbono...@apache.org > >> http://blog.nanthrax.net > >> Talend - http://www.talend.com > >> > >> > >> > > > > -- > Jean-Baptiste Onofré > jbono...@apache.org > http://blog.nanthrax.net > Talend - http://www.talend.com > -- -- Christian Schneider http://www.liquid-reality.de Computer Scientist http://www.adobe.com
