[bt-devel] Getting started

[Jaak Ristioja]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 13.01.2013 04:53, John B. Turpish wrote:
> I had received an email from Thomas Abthorpe offering to sign me up
> for the wiki before reading this one, so I went ahead and asked him
> to set me up.

Nice. :) Thanks Thomas!

> The "Join Us" directions actually didn't tell me to get the source
> from sourceforge, and I hadn't - I had already used gitorious as
> recommended on the wiki's main page
> <http://devel.bibletime.info/wiki/Main_Page>. What it does say is,
> " We need your username to add you to the team members list, to
> assign tasks to you, etc.", so I had assumed sourceforge was being
> used for a bug tracker. Do you have some other issue tracking being
> used?

Yes. Our bugzilla is at http://bugs.bibletime.info/. We've been trying
to move from the SourceForge tracker to bugzilla.

> What sort of refactoring did you have in mind? Just basic
> decomposition and maybe DRY stuff? Anything specific bothering you?
> Even if I don't do anything too extensive at least I should keep
> the project's direction in mind so if I do do anything it will be
> in the right direction.

I'm relatively new in BibleTime myself, but what I've heard from our
veterans is that when BibleTime was first created, none of the
developers had had much training in software design, software
development or C++. Given that, they did a really great job!
Unfortunately, maintaining or extending it has not been a pleasure,
and there are still some architectural skeletons hiding in the closet.
We've managed to eliminate many such issues, but there are still many
around.

Thinking about how I have approached coding BibleTime, the main goals
have been along the lines of enhancing the coding experience:
  1) Trying to understand the code and trying to make it
understandable by means of:
  2) refactoring for simplicity (DRY, simpler design patterns) and
reusability so that it were simpler in the future to enhance (and
maintain) BibleTime.
  3) documenting stuff that isn't obvious.
  4) enhancing the build system (for usability and portability)
  5) etc etc etc to make any future development more effective and
enjoyable.

> As for retranslateUi... $find src -type f -exec grep -vl
> retranslateUi '{}' + | xargs grep -l 'tr(' | wc -l 94 Seems to me
> the sort of thing I'd keep in mind to do to whichever file I may
> touch for whatever other reason more than something I'm likely to 
> sit down and do all at once. I don't want to sound like a jerk, I
> just know that with my other commitments (job, family, other
> projects) plus my general lack of stick-to-it-iveness...

No problem. Thats stuff we all struggle with. The truth is that there
are just more important things in life that writing code for
BibleTime, and in many cases, BibleTime just has to wait. Thats okay.

> I don't want to overcommit and make promises I may not keep.

Perfectly understandable and acceptable. I guess I can't say for
myself that I've always done that with regards to BibleTime.

> One thing that did stand out to me: the file heading 
> <http://devel.bibletime.info/wiki/Programming_Guidelines#Headers_and_implementations>
>
> 
does not include the Trinitarian Formula, which seems to have been
> recommended over here
> <http://devel.bibletime.info/wiki/Junior_Jobs>. So, is it desired
> or not? Part of the reason I ask - since I had seen that in "Junior
> Jobs" I started writing a script to do that to all the headers. I
> didn't finish because the train announced it was approaching my
> stop, and I won't bother picking that back up if it's not desired.

Well, the downside of this would be that we'd need to think of more
junior jobs... =)

Otherwise I think it were a good idea to remind us all that coding for
BibleTime should be something we're ultimately not doing for ourselves
but for a greater goal of serving all people and God. This has
originally been my idea and I'm not sure how other developers feel
about it. Its just that coding is mentally challenging work and I
don't want BibleTime to be just another random piece of code we just
work and work and work on. In the midst of all that hard labor I want
it to remind us of Christ, our Lord.

But... maybe its just me who sometime forgets. A script for something
like that would be nice. What do others think?


Blessings,
Jaak
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.19 (GNU/Linux)

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
leaSAH06AfWLWfJIeWay
=4/1n
-----END PGP SIGNATURE-----