tobi, please u can made corrections or whatever, i not a english speaker, and a web contribution guie its need for MANY users... Lenz McKAY Gerardo (PICCORO) http://qgqlochekone.blogspot.com
2017-04-01 18:22 GMT-04:00 Tobias Boege <tabo...@gmail.com>: > On Sat, 01 Apr 2017, PICCORO McKAY Lenz wrote: >> continued with the how to and ported to gambas wiki now: >> >> http://gambaswiki.org/wiki/howto/getstartedwebgambas >> >> with the basic to deploay the app cgi inside the webserver as per user or >> globally, also minimal knowledge and requirements >> >> the article was updates too: >> http://qgqlochekone.blogspot.com/2017/03/gambas-como- >> publicar-web-how-to-deploy.html >> > > To be frank, I don't know what to think of this entry in the wiki. Please > believe me that new content is always great to have and your effort is > appreciated, so that I can focus on the things I dislike in this mail with > a clean conscience. > > Naturally, the first point is the spelling. If it wasn't for the spelling > I wouldn't have bothered to write a mail, but since it has surpassed my > inhibition threshold, let me also comment on the contents further below. > > I strongly suggest you find yourself a volunteer to go over the article > and produce an actual English text. There are literally as many errors as > there are lines in the document, maybe more. Of course, I'm not the wiki > police and I won't dare to delete your article, but, honestly, I want to. > The whole presentation is a little embarrassing, to the point where I have > trouble saying "it's better than nothing", averaged over all aspects of > the document (+ the information, - the presentation). > > There are also questionable lines like > >> due unfortunatelly ide when runs make a own embebed web erver > > Why is that unfortunate? Is gb.httpd a bother and should be removed? This > sounds either like your opinion or a filler word, and IMHO it should be > left out in both cases. The part before this reads > >> also note that test the webpage inside the ide its not same as called from >> url browser, > > As a matter of fact, you use the same web (url?) browser to access and > view the output of your project, regardless of whether you run it from the > IDE or from a proper web server. You seem to be targeting gb.httpd but how > is it not the same? I mean, yes, I think I've seen some differences in the > setting of CGI variables across default configurations of web servers, but > the reader of your article would probably like an example of what you're > getting at here, because the web browser handles both types of web servers > the same. > > Then I don't get why you discriminate between Gambas scripts and compiled > Gambas projects. Sure: one is compiled and the other isn't, but both are > CGI scripts with a shebang, so what's the point? As CGI scripts they are > not more different than they are as Gambas executables. > > There are other things I personally disagree with, like the scope of your > document: > >> second Need understand REALLY the concepts of request Request and response >> Response > > Why is this an "Installation requirement"? > >> As general furter info high end production environments must configure as a >> duple >> of a server frontend that provides a proxy reverse to the real cgi webserver >> with >> the gambas3 cgi program. > >> the server GCI standars values, those are very important to understant for >> high level >> production webpages. > > You originally wanted to write a HowTo for using Gambas CGI on a real web > server, not about high-level production development. > > If I were to start writing such an article, I would make a clear cut between > > (1) Installing Gambas > Might as well include a small section about this. I installed Gambas > from sources on my CentOS server. Since that naturally goes without > GUI, produces lots of missing component warnings and all that, it > might be the newbie-friendly way to talk about these things. IIRC I > even needed to patch the gb.db.mysql/configure.ac because /usr/lib > isn't symlinked to /usr/lib64 on my system, so the configure script > failed to find some libraries. Chances are people want to use a > fairly recent Gambas version, too, to get new features and fixes in > the gb.web.form component, so I think installing Gambas is a relevant > topic here. > > (2) Essentials of Gambas CGI programming > The relevant components are gb.web and gb.web.form. Choosing a > "web application" in the IDE project creation dialog will only turn > on gb.web (and gb.util.web). I would write a small application that > uses some gb.web classes: parses Request.Path (preferably without > producing a directory traversal vulnerability) and uses the Response > and Session classes in a non-trivial way -- all this without going > into much detail on the HTTP protocol, CGI variables, database > connectivity and what else a serious application may require. This is > all stuff the user will learn on the side and has no reason to be in > the Gambas wiki. I would probably not more than mention Gambas > WebPages because I never used them. At the end of this section, the > reader would have seen the sources of a Gambas CGI application and > knows he can use gb.httpd to debug his own code. > > (3) Installing and configuring the web server > Your instructions could have been much clearer. For starters, I would > replace the table with subsections in the document, dealing with apache > and lighttpd separately, linking to relevant documentation, give the > reader an idea where the configuration files could be located on their > distro, etc.. This might easily be the most important part of the > article for most people which are already familiar with Gambas. Don't > just squeeze all the stuff into a table without any discussion at all. > > Again, I'm sorry if some parts come off as too direct. It's already past bed > time here. > > Regards, > Tobi > > -- > "There's an old saying: Don't change anything... ever!" -- Mr. Monk > > ------------------------------------------------------------------------------ > Check out the vibrant tech community on one of the world's most > engaging tech sites, Slashdot.org! http://sdm.link/slashdot > _______________________________________________ > Gambas-user mailing list > Gambas-user@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/gambas-user ------------------------------------------------------------------------------ Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot _______________________________________________ Gambas-user mailing list Gambas-user@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/gambas-user