Thread: [smartweb-user] Re : Documentation
Brought to you by:
rlogiacco
Menu
▾
▴
smartweb-user
|
From: Sébastien LE C. <sl...@ya...> - 2009-06-24 13:29:28
|
+1. Because I think Wiki is just perfect for this, and I'm allergic to the apt format (unless you're thinking of something more xdoc-like?) The documentation plan sounds also good. Will the How to part contain examples? Regards, Sebastien. ----- Message d'origine ---- > De : Roberto Lo Giacco <rlo...@sm...> > À : SmartWeb Developers List <sma...@li...>; SmartWeb Users List <sma...@li...> > Envoyé le : Mercredi, 17 Juin 2009, 11h24mn 50s > Objet : [smartweb-user] Documentation > > I wish to try to solve the documentation problem afflicting this project > and I need your support both for decisions and for production. > > First of all we have to choose a documentation method between Wiki and > Maven generated pages. I wish to know your opinions and I want to call a > vote about this: +1 means you think Wiki is better, -1 you think Maven > is better, 0 you don't have an opinion or you can't decide between them. > > We need to establish the user manual structure and I think Annamaria > idea is good, I'm going to repost it here in it's simpler version and > explain the contents: > > - overview > we present the framework, the objectives, the architectural and > structural overview including when and why to use it > > - quick start > the minimal, step-by-step instructions to start working with the > framework and buil your first simple HelloWorld application > > - guided tour > a fully comprehensive guide throughout the framework, from the business > model to the persistence tier raising to the presentation tier so we can > depict in the tour a good practice in using the framework itself > > - how to > a collection of how to perform some specific tasks, like how to use two > databases, how to write unit tests, how to use modules and so on > > - problems resolution > a collection of common errors and their resolution > > Each module will have it's own documentation with the same structure but > with contents constrained to the the module. > > -- > > Roberto Lo Giacco > > Chief Technical Officer > SmartLab s.r.l. > via Spagna, snc - 87036 Rende (CS) - Italy > > Mobile: +39 392 8765657 > Email: rlo...@sm... > Skype: longisland-75 > Web: http://www.smartlab.it > > > ------------------------------------------------------------------------------ > Crystal Reports - New Free Runtime and 30 Day Trial > Check out the new simplified licensing option that enables unlimited > royalty-free distribution of the report engine for externally facing > server and web deployment. > http://p.sf.net/sfu/businessobjects > _______________________________________________ > smartweb-user mailing list > sma...@li... > https://lists.sourceforge.net/lists/listinfo/smartweb-user |
|
From: Roberto Lo G. <rlo...@sm...> - 2009-06-24 19:34:56
|
Sébastien LE CALLONNEC wrote: > +1. Because I think Wiki is just perfect for this, and I'm allergic to the apt format (unless you're thinking of something more xdoc-like?) > The documentation plan sounds also good. Will the How to part contain examples? > > I was thinking to code excerpts more than complete examples... but let's see what we really need case by case. Thank you for you vote Seb! It' good to see you have not abandoned us! ;) > Regards, > Sebastien. > > ----- Message d'origine ---- > >> De : Roberto Lo Giacco <rlo...@sm...> >> À : SmartWeb Developers List <sma...@li...>; SmartWeb Users List <sma...@li...> >> Envoyé le : Mercredi, 17 Juin 2009, 11h24mn 50s >> Objet : [smartweb-user] Documentation >> >> I wish to try to solve the documentation problem afflicting this project >> and I need your support both for decisions and for production. >> >> First of all we have to choose a documentation method between Wiki and >> Maven generated pages. I wish to know your opinions and I want to call a >> vote about this: +1 means you think Wiki is better, -1 you think Maven >> is better, 0 you don't have an opinion or you can't decide between them. >> >> We need to establish the user manual structure and I think Annamaria >> idea is good, I'm going to repost it here in it's simpler version and >> explain the contents: >> >> - overview >> we present the framework, the objectives, the architectural and >> structural overview including when and why to use it >> >> - quick start >> the minimal, step-by-step instructions to start working with the >> framework and buil your first simple HelloWorld application >> >> - guided tour >> a fully comprehensive guide throughout the framework, from the business >> model to the persistence tier raising to the presentation tier so we can >> depict in the tour a good practice in using the framework itself >> >> - how to >> a collection of how to perform some specific tasks, like how to use two >> databases, how to write unit tests, how to use modules and so on >> >> - problems resolution >> a collection of common errors and their resolution >> >> Each module will have it's own documentation with the same structure but >> with contents constrained to the the module. >> >> -- >> >> Roberto Lo Giacco >> >> Chief Technical Officer >> SmartLab s.r.l. >> via Spagna, snc - 87036 Rende (CS) - Italy >> >> Mobile: +39 392 8765657 >> Email: rlo...@sm... >> Skype: longisland-75 >> Web: http://www.smartlab.it >> >> >> ------------------------------------------------------------------------------ >> Crystal Reports - New Free Runtime and 30 Day Trial >> Check out the new simplified licensing option that enables unlimited >> royalty-free distribution of the report engine for externally facing >> server and web deployment. >> http://p.sf.net/sfu/businessobjects >> _______________________________________________ >> smartweb-user mailing list >> sma...@li... >> https://lists.sourceforge.net/lists/listinfo/smartweb-user >> > > > > > ------------------------------------------------------------------------------ > _______________________________________________ > smartweb-user mailing list > sma...@li... > https://lists.sourceforge.net/lists/listinfo/smartweb-user > -- Roberto Lo Giacco Chief Technical Officer SmartLab s.r.l. via Spagna, snc - 87036 Rende (CS) - Italy Mobile: +39 392 8765657 Email: rlo...@sm... Skype: longisland-75 Web: http://www.smartlab.it |
|
From: Sébastien LE C. <sl...@ya...> - 2009-06-25 09:09:18
|
Yep, still lurking in the background, keeping an eye on where things are going! btw, any plan of moving to Struts2? I don't think I've seen this mentioned anywhere. ----- Message d'origine ---- > De : Roberto Lo Giacco <rlo...@sm...> > À : Framework Users Discussions <sma...@li...>; SmartWeb Developers List <sma...@li...> > Envoyé le : Mercredi, 24 Juin 2009, 20h26mn 01s > Objet : Re: [smartweb-user] Re : Documentation > > Sébastien LE CALLONNEC wrote: > > +1. Because I think Wiki is just perfect for this, and I'm allergic to the > apt format (unless you're thinking of something more xdoc-like?) > > The documentation plan sounds also good. Will the How to part contain > examples? > > > > > I was thinking to code excerpts more than complete examples... but let's > see what we really need case by case. > > Thank you for you vote Seb! It' good to see you have not abandoned us! ;) > > Regards, > > Sebastien. > > > > ----- Message d'origine ---- > > > >> De : Roberto Lo Giacco > >> À : SmartWeb Developers List ; SmartWeb > Users List > >> Envoyé le : Mercredi, 17 Juin 2009, 11h24mn 50s > >> Objet : [smartweb-user] Documentation > >> > >> I wish to try to solve the documentation problem afflicting this project > >> and I need your support both for decisions and for production. > >> > >> First of all we have to choose a documentation method between Wiki and > >> Maven generated pages. I wish to know your opinions and I want to call a > >> vote about this: +1 means you think Wiki is better, -1 you think Maven > >> is better, 0 you don't have an opinion or you can't decide between them. > >> > >> We need to establish the user manual structure and I think Annamaria > >> idea is good, I'm going to repost it here in it's simpler version and > >> explain the contents: > >> > >> - overview > >> we present the framework, the objectives, the architectural and > >> structural overview including when and why to use it > >> > >> - quick start > >> the minimal, step-by-step instructions to start working with the > >> framework and buil your first simple HelloWorld application > >> > >> - guided tour > >> a fully comprehensive guide throughout the framework, from the business > >> model to the persistence tier raising to the presentation tier so we can > >> depict in the tour a good practice in using the framework itself > >> > >> - how to > >> a collection of how to perform some specific tasks, like how to use two > >> databases, how to write unit tests, how to use modules and so on > >> > >> - problems resolution > >> a collection of common errors and their resolution > >> > >> Each module will have it's own documentation with the same structure but > >> with contents constrained to the the module. > >> > >> -- > >> > >> Roberto Lo Giacco > >> > >> Chief Technical Officer > >> SmartLab s.r.l. > >> via Spagna, snc - 87036 Rende (CS) - Italy > >> > >> Mobile: +39 392 8765657 > >> Email: rlo...@sm... > >> Skype: longisland-75 > >> Web: http://www.smartlab.it > >> > >> > >> > ------------------------------------------------------------------------------ > >> Crystal Reports - New Free Runtime and 30 Day Trial > >> Check out the new simplified licensing option that enables unlimited > >> royalty-free distribution of the report engine for externally facing > >> server and web deployment. > >> http://p.sf.net/sfu/businessobjects > >> _______________________________________________ > >> smartweb-user mailing list > >> sma...@li... > >> https://lists.sourceforge.net/lists/listinfo/smartweb-user > >> > > > > > > > > > > ------------------------------------------------------------------------------ > > _______________________________________________ > > smartweb-user mailing list > > sma...@li... > > https://lists.sourceforge.net/lists/listinfo/smartweb-user > > > > > -- > > Roberto Lo Giacco > > Chief Technical Officer > SmartLab s.r.l. > via Spagna, snc - 87036 Rende (CS) - Italy > > Mobile: +39 392 8765657 > Email: rlo...@sm... > Skype: longisland-75 > Web: http://www.smartlab.it > > > ------------------------------------------------------------------------------ > _______________________________________________ > smartweb-user mailing list > sma...@li... > https://lists.sourceforge.net/lists/listinfo/smartweb-user |
|
From: Roberto Lo G. <rlo...@sm...> - 2009-06-25 10:28:57
|
Sébastien LE CALLONNEC wrote: > Yep, still lurking in the background, keeping an eye on where things are going! > > btw, any plan of moving to Struts2? I don't think I've seen this mentioned anywhere. > do you think moving to struts2 will be a good choice? i don't like very much the event based approach... it will move us toward jsf which didn't catch very much attention, at least not as expected in first place -- Roberto Lo Giacco Chief Technical Officer SmartLab s.r.l. via Spagna, snc - 87036 Rende (CS) - Italy Mobile: +39 392 8765657 Email: rlo...@sm... Skype: longisland-75 Web: http://www.smartlab.it |
|
From: Sébastien LE C. <sl...@ya...> - 2009-06-25 19:03:33
|
I have not had the chance to play much with it, but as far as I can remember, it was very similar to Struts 1 in spirit, with the exception of not being forced to use an "execute" method, and one generic library. But again, I should/will look into it a bit more. I was just asking because it looks like some Struts 2 projects might be coming up, and as I'm starting to look around, I waswondering if you guys had considered it. Thanks, Sebastien. ----- Message d'origine ---- > De : Roberto Lo Giacco <rlo...@sm...> > À : Framework Users Discussions <sma...@li...> > Envoyé le : Jeudi, 25 Juin 2009, 11h28mn 44s > Objet : Re: [smartweb-user] Re : Re : Documentation > > Sébastien LE CALLONNEC wrote: > > Yep, still lurking in the background, keeping an eye on where things are > going! > > > > btw, any plan of moving to Struts2? I don't think I've seen this mentioned > anywhere. > > > do you think moving to struts2 will be a good choice? i don't like very > much the event based approach... it will move us toward jsf which didn't > catch very much attention, at least not as expected in first place > > -- > > Roberto Lo Giacco > > Chief Technical Officer > SmartLab s.r.l. > via Spagna, snc - 87036 Rende (CS) - Italy > > Mobile: +39 392 8765657 > Email: rlo...@sm... > Skype: longisland-75 > Web: http://www.smartlab.it > > > ------------------------------------------------------------------------------ > _______________________________________________ > smartweb-user mailing list > sma...@li... > https://lists.sourceforge.net/lists/listinfo/smartweb-user |
|
From: Roberto Lo G. <rlo...@sm...> - 2009-06-25 21:15:34
|
Sébastien LE CALLONNEC wrote: > I have not had the chance to play much with it, but as far as I can remember, it was very similar to Struts 1 in spirit, with the exception of not being forced to use an "execute" method, and one generic library. But again, I should/will look into it a bit more. > > I was just asking because it looks like some Struts 2 projects might be coming up, and as I'm starting to look around, I waswondering if you guys had considered it. > > Thanks, > Sebastien. > > > > ----- Message d'origine ---- > >> De : Roberto Lo Giacco <rlo...@sm...> >> À : Framework Users Discussions <sma...@li...> >> Envoyé le : Jeudi, 25 Juin 2009, 11h28mn 44s >> Objet : Re: [smartweb-user] Re : Re : Documentation >> >> Sébastien LE CALLONNEC wrote: >> >>> Yep, still lurking in the background, keeping an eye on where things are >>> >> going! >> >>> btw, any plan of moving to Struts2? I don't think I've seen this mentioned >>> >> anywhere. >> >>> >>> >> do you think moving to struts2 will be a good choice? i don't like very >> much the event based approach... it will move us toward jsf which didn't >> catch very much attention, at least not as expected in first place >> >> -- >> >> Roberto Lo Giacco >> >> Chief Technical Officer >> SmartLab s.r.l. >> via Spagna, snc - 87036 Rende (CS) - Italy >> >> Mobile: +39 392 8765657 >> Email: rlo...@sm... >> Skype: longisland-75 >> Web: http://www.smartlab.it >> >> >> ------------------------------------------------------------------------------ >> _______________________________________________ >> smartweb-user mailing list >> sma...@li... >> https://lists.sourceforge.net/lists/listinfo/smartweb-user >> > > > > > > ------------------------------------------------------------------------------ > _______________________________________________ > smartweb-user mailing list > sma...@li... > https://lists.sourceforge.net/lists/listinfo/smartweb-user > we will appreciate very much your opinion -- Roberto Lo Giacco Chief Technical Officer SmartLab s.r.l. via Spagna, snc - 87036 Rende (CS) - Italy Mobile: +39 392 8765657 Email: rlo...@sm... Skype: longisland-75 Web: http://www.smartlab.it |
×
Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.
Thanks for helping keep SourceForge clean.
X