Education ClassRoom/Previous Logs/OpenOffice.org Coding Guidelines
[16:59] <thorsten> --- classroom in ~1 minute ---
[16:59] <thorsten> there's a little intro presentation - http://wiki.services.openoffice.org/w/images/7/72/C%2B%2B- codingstandards.pdf
[17:00] * fredus (n=fredus@138.219.77-86.rev.gaoland.net) has joined #education.openoffice.org
[17:00] <metrokid> thank you for the file
[17:00] <thorsten> ok, hi everybody,
[17:01] <metrokid> hi
[17:01] <ericb2> thorsten: hello. Thanks for accepting to manage this ClassRoom.
[17:01] <thorsten> I'd like to start with the ooo coding standards classroom now,
[17:01] <Guillaume[ecn]> Hello
[17:01] <ericb2> @ all :
[17:02] <ericb2> we use to start with ~20 to 30 minutes of presentation, then questions
[17:02] <ericb2> but things can be adapted, of course
[17:02] <ericb2> thanks for your attention, and let's start :-)
[17:02] <thorsten> thanks ericb2 for the invitation,
[17:03] <thorsten> let's start with a quick motivational presentation about why coding standards & what for ;)
[17:03] <thorsten> #slide 2:
[17:03] <thorsten> has the link to the c++ coding standards for OOo,
[17:03] <thorsten> which I'll mostly focus on
[17:04] <thorsten> there are coding guidelines for perl & java as well,
[17:04] <thorsten> but ~90% of OOo is C++, so... ;)
[17:04] <thorsten> everybody able to see the media?
[17:04] <Guillaume[ecn]> yep
[17:04] <thorsten> good :)
[17:04] <thorsten> slide #3
[17:04] <IZBot> no issue with number 3
[17:04] <IZBot> no issue with number 3
[17:05] <thorsten> haha
[17:05] <thorsten> so, you can read the content for yourself -
[17:05] <thorsten> there's a bunch of reasons to have coding standards,
[17:05] * metrokid reading Origins of Standards
[17:05] <thorsten> for me, one of the most important is to have a common vocabulary,
[17:06] <thorsten> and, especially for c++, to limit the variations, i.e.
[17:06] <thorsten> have a somewhat bounded problem space, when trying to express a certain kind of functionality
[17:06] <thorsten> like - use c-like, all-macros kind of coding vs. using boost -
[17:07] <thorsten> if that's mixed, people have an even harder time reading other's code
[17:07] <thorsten> a second thing is, and that's prolly best shown by this page:
[17:08] * mmu_man has quit ("Vision[0.9.7-Z-101305]: i've been blurred!")
[17:08] <thorsten> http://wiki.services.openoffice.org/wiki/Writer_Code_Conventions
[17:09] <thorsten> to give best-practice examples of how other people solved generic problems
[17:09] <thorsten> @ all: questions so far?
[17:09] <thorsten> cool.
[17:10] <thorsten> so, we based this on some standard literature, and experience we had in OOo,
[17:10] <thorsten> but, like, this did not fall from the skies :)
17:10] <thorsten> slide #4, btw
[17:10] <IZBot> no issue with number 4
[17:11] <thorsten> slide 5:
[17:11] <thorsten> you speak up when I'm too fast or too slow, ok?
[17:11] <Guillaume[ecn]> k
[17:11] <ssaboum> ok
[17:11] <thorsten> cool
[17:11] <thorsten> so,
[17:11] <metrokid> ok
[17:11] <thorsten> having rules is all nice & sweet, but
[17:12] <thorsten> if you don't actually use them, e.g. by reviewing code for them,
[17:12] <thorsten> there's mostly theoretical value in them :)