Re: [slf4j-user] SLF4J library using an image
I'd like to thank you all for your feedback and contributions on these illustrations. -- Ceki ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Am 14.08.2011 um 22:56 schrieb Ceki Gülcü: Hi all, I've updated the illustrations taking into account your comments. With the additional description of the arrows in the legend it looks good to me. One more thing which just came to my mind: I would prefer Adaptation layer and Underlying logging framework boxes in another (slightly different) color in order to visually distinguish the three different layers: API, Adaptation, Underlying logging framework. You could even adjust the different variants in concrete-bindings.png to have all the same vertical hight so that it is visually stressed that for some there is no adaptation layer while for others there is no underlying logging framework layer. Thorsten The updated files are located at: http://slf4j.org/images/concrete-bindings.odg http://slf4j.org/images/concrete-bindings.png http://slf4j.org/images/legacy.odg http://slf4j.org/images/legacy.png The audience for these illustrations are users with little or no prior understanding of or exposure to SLF4J. More concretely, with the help of these illustrations, new users should hopefully stop placing multiple binding artifacts on the class path at the same time. IMO, the arrows convey useful information with respect to direction of invocations albeit perhaps in a stylistically inelegant way. Anyway, your suggestions for further improvements most welcome. In particular regarding the unification of the stacked and arrowed styles (if possible). Cheers, -- QOS.ch, main sponsor of cal10n, logback and slf4j open source projects, is looking to hire talented software developers. For further details, see http://logback.qos.ch/job.html ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Hello Ceki, I've added some color and removed the adaption layer from the 'unbound' case. What do you think? http://no-commons-logging.zapto.org/concrete-bindings-eoo.odg http://no-commons-logging.zapto.org/concrete-bindings-eoo.png I think that displaying these stacks horizontally would improve the presentation somewhat more. It emphasizes what a mess you have when you include commons-logging in the mix :) Regards, Erik. Op 14-08-11 22:56, Ceki Gülcü schreef: Hi all, I've updated the illustrations taking into account your comments. The updated files are located at: http://slf4j.org/images/concrete-bindings.odg http://slf4j.org/images/concrete-bindings.png http://slf4j.org/images/legacy.odg http://slf4j.org/images/legacy.png The audience for these illustrations are users with little or no prior understanding of or exposure to SLF4J. More concretely, with the help of these illustrations, new users should hopefully stop placing multiple binding artifacts on the class path at the same time. IMO, the arrows convey useful information with respect to direction of invocations albeit perhaps in a stylistically inelegant way. Anyway, your suggestions for further improvements most welcome. In particular regarding the unification of the stacked and arrowed styles (if possible). Cheers, ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Am 13.08.2011 um 22:17 schrieb jakartaman: Now someone needs to take a decision!!11!! Well, just my opinion: both make sense to me. Erik's original version clearly and tersely describes the (gradual) transition from a logging framework other than SLF4J up to the point where just SLF4J backed by Logback is used. And I presume depicting this transition was Erik's intention. Ceki's version appeared more comprehensive to me in depicting all the combinations in which SLF4J can be deployed. Honestly, however, I was interrupted a bit by the arrows since their semantics is not intuitive and was also not explained in the legend. To me they are not really necessary and I would prefer the typical layered way of depicting it using vertically stacked boxes. To conclude, both are reasonable to the projects documentation, just at different places: Erik's could be used for supporting one way (the preferred way?) of (gradually) moving from another logging framework to pure SLF4J logging; Ceki's could be used to support all the different deployment combinations. Thorsten :-) On 08/13/2011 10:51 AM, Rusty Wright wrote: I definitely like http://slf4j.org/images/concrete-bindings.png Straightforward and clear. On 2011-08-12 12:32, Ceki Gülcü wrote: I've taken yet another crack at this: http://slf4j.org/images/concrete-bindings.odg http://slf4j.org/images/concrete-bindings.png http://slf4j.org/images/legacy.odg http://slf4j.org/images/legacy.png The idea is to illustrate concrete binding setups using lots of arrows. :-) On 12/08/2011 9:04 AM, Erik van Oosten wrote: Hi David, I liked the clearness of your images as the result of using no arrows and different colors for each function. I did have troubles with the text, the font size is a tad small for me. The second image does not show that commons-logging attempts to find a logging implementation such as log4j, nor that is specially wired in the classpath of many servlet containers. Not sure how to do visualize that though. Regards, Erik. ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Small correction: the 'original' version is David's (jakartaman). For the rest I agree. Regards, Erik. Op 14-08-11 13:35, Thorsten Möller schreef: Am 13.08.2011 um 22:17 schrieb jakartaman: Now someone needs to take a decision!!11!! Well, just my opinion: both make sense to me. Erik's original version clearly and tersely describes the (gradual) transition from a logging framework other than SLF4J up to the point where just SLF4J backed by Logback is used. And I presume depicting this transition was Erik's intention. Ceki's version appeared more comprehensive to me in depicting all the combinations in which SLF4J can be deployed. Honestly, however, I was interrupted a bit by the arrows since their semantics is not intuitive and was also not explained in the legend. To me they are not really necessary and I would prefer the typical layered way of depicting it using vertically stacked boxes. To conclude, both are reasonable to the projects documentation, just at different places: Erik's could be used for supporting one way (the preferred way?) of (gradually) moving from another logging framework to pure SLF4J logging; Ceki's could be used to support all the different deployment combinations. Thorsten :-) On 08/13/2011 10:51 AM, Rusty Wright wrote: I definitely like http://slf4j.org/images/concrete-bindings.png Straightforward and clear. On 2011-08-12 12:32, Ceki Gülcü wrote: I've taken yet another crack at this: http://slf4j.org/images/concrete-bindings.odg http://slf4j.org/images/concrete-bindings.png http://slf4j.org/images/legacy.odg http://slf4j.org/images/legacy.png The idea is to illustrate concrete binding setups using lots of arrows. :-) On 12/08/2011 9:04 AM, Erik van Oosten wrote: Hi David, I liked the clearness of your images as the result of using no arrows and different colors for each function. I did have troubles with the text, the font size is a tad small for me. The second image does not show that commons-logging attempts to find a logging implementation such as log4j, nor that is specially wired in the classpath of many servlet containers. Not sure how to do visualize that though. Regards, Erik. ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user -- Erik van Oosten http://www.day-to-day-stuff.blogspot.com/ ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Am 14.08.2011 um 17:33 schrieb Erik van Oosten: Small correction: the 'original' version is David's (jakartaman). uups, sorry ;-) Thorsten For the rest I agree. Regards, Erik. Op 14-08-11 13:35, Thorsten Möller schreef: Am 13.08.2011 um 22:17 schrieb jakartaman: Now someone needs to take a decision!!11!! Well, just my opinion: both make sense to me. Erik's original version clearly and tersely describes the (gradual) transition from a logging framework other than SLF4J up to the point where just SLF4J backed by Logback is used. And I presume depicting this transition was Erik's intention. Ceki's version appeared more comprehensive to me in depicting all the combinations in which SLF4J can be deployed. Honestly, however, I was interrupted a bit by the arrows since their semantics is not intuitive and was also not explained in the legend. To me they are not really necessary and I would prefer the typical layered way of depicting it using vertically stacked boxes. To conclude, both are reasonable to the projects documentation, just at different places: Erik's could be used for supporting one way (the preferred way?) of (gradually) moving from another logging framework to pure SLF4J logging; Ceki's could be used to support all the different deployment combinations. Thorsten :-) On 08/13/2011 10:51 AM, Rusty Wright wrote: I definitely like http://slf4j.org/images/concrete-bindings.png Straightforward and clear. On 2011-08-12 12:32, Ceki Gülcü wrote: I've taken yet another crack at this: http://slf4j.org/images/concrete-bindings.odg http://slf4j.org/images/concrete-bindings.png http://slf4j.org/images/legacy.odg http://slf4j.org/images/legacy.png The idea is to illustrate concrete binding setups using lots of arrows. :-) On 12/08/2011 9:04 AM, Erik van Oosten wrote: Hi David, I liked the clearness of your images as the result of using no arrows and different colors for each function. I did have troubles with the text, the font size is a tad small for me. The second image does not show that commons-logging attempts to find a logging implementation such as log4j, nor that is specially wired in the classpath of many servlet containers. Not sure how to do visualize that though. Regards, Erik. ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user -- Erik van Oosten http://www.day-to-day-stuff.blogspot.com/ ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Hi all, I've updated the illustrations taking into account your comments. The updated files are located at: http://slf4j.org/images/concrete-bindings.odg http://slf4j.org/images/concrete-bindings.png http://slf4j.org/images/legacy.odg http://slf4j.org/images/legacy.png The audience for these illustrations are users with little or no prior understanding of or exposure to SLF4J. More concretely, with the help of these illustrations, new users should hopefully stop placing multiple binding artifacts on the class path at the same time. IMO, the arrows convey useful information with respect to direction of invocations albeit perhaps in a stylistically inelegant way. Anyway, your suggestions for further improvements most welcome. In particular regarding the unification of the stacked and arrowed styles (if possible). Cheers, -- QOS.ch, main sponsor of cal10n, logback and slf4j open source projects, is looking to hire talented software developers. For further details, see http://logback.qos.ch/job.html ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Now someone needs to take a decision!!11!! :-) On 08/13/2011 10:51 AM, Rusty Wright wrote: I definitely like http://slf4j.org/images/concrete-bindings.png Straightforward and clear. On 2011-08-12 12:32, Ceki Gülcü wrote: I've taken yet another crack at this: http://slf4j.org/images/concrete-bindings.odg http://slf4j.org/images/concrete-bindings.png http://slf4j.org/images/legacy.odg http://slf4j.org/images/legacy.png The idea is to illustrate concrete binding setups using lots of arrows. :-) On 12/08/2011 9:04 AM, Erik van Oosten wrote: Hi David, I liked the clearness of your images as the result of using no arrows and different colors for each function. I did have troubles with the text, the font size is a tad small for me. The second image does not show that commons-logging attempts to find a logging implementation such as log4j, nor that is specially wired in the classpath of many servlet containers. Not sure how to do visualize that though. Regards, Erik. ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
I've taken yet another crack at this: http://slf4j.org/images/concrete-bindings.odg http://slf4j.org/images/concrete-bindings.png http://slf4j.org/images/legacy.odg http://slf4j.org/images/legacy.png The idea is to illustrate concrete binding setups using lots of arrows. :-) On 12/08/2011 9:04 AM, Erik van Oosten wrote: Hi David, I liked the clearness of your images as the result of using no arrows and different colors for each function. I did have troubles with the text, the font size is a tad small for me. The second image does not show that commons-logging attempts to find a logging implementation such as log4j, nor that is specially wired in the classpath of many servlet containers. Not sure how to do visualize that though. Regards, Erik. -- QOS.ch, main sponsor of cal10n, logback and slf4j open source projects, is looking to hire talented software developers. For further details, see http://logback.qos.ch/job.html ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
Re: [slf4j-user] SLF4J library using an image
Hi Ceki, Here is the new version: http://public.m-plify.neT/SLF4J_intro/SLF4J_intro.odg http://public.m-plify.neT/SLF4J_intro/SLF4J_intro.png http://public.m-plify.neT/SLF4J_intro/SLF4J_intro.tif Best regards, -- David On 08/10/2011 04:22 PM, Ceki Gülcü wrote: On 10/08/2011 4:10 PM, jakartaman wrote: Hi guys, I have finagled a little image to explain the SLF4J library in 10 seconds. Maybe someone wants to recycle it for the the SLF4J documentation page (I don't doubt there are other images though). Have a look: http://public.m-plify.net/SLF4J_intro.png -- An 1,500px × 523px PNG http://public.m-plify.net/SLF4J_intro.vsd -- The Microsoft Visio file used to generate the above Best regards, -- David Hi David, I very much like the idea of a graphic better explaining SLF4J. Instead of an abstract logging API such as X logging API, I think it would be clearer to present concrete cases as log4j, jul or logback. Would you want to work on this using an open source tool such as Open Office Draw? (I don't own a copy of Visio). -- Ceki ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user ___ slf4j-user mailing list slf4j-user@qos.ch http://qos.ch/mailman/listinfo/slf4j-user
