Kephra / lib / StyleGuide.pod

=head1 Kephra Coding Style

=head2 Technical Details

    bracketing     = K & R
    indention size = 4
    use of tabs    = yes

=head2 Organisation

1 module - 1 namespace

=head2 Naming

We try to reuse same names for similar purposes,
especially when its the same purpose through several modules,
or the same data part through different structures.

We also try to lean toward natural Perl names (eg 'sub' 'coderef', 'push').

=head3 module/class Names

titlecase / camelcase       ~~ LikeThis

=head3 sub/method Names

lowercase words separated by _ ~~ like_this

routines only to be called inside a module start with one _
avoid to call these from outside by all means

create not make when we generate something

=head3 Variable Names

lowercase words separated by _ ~~ like_this
We say active, no more current or recent.

$self  reference of the class itself

$ed    in most cases the active editor pane
       (was renamed from $ep to prevent simple copy and paste of old code)

$file  full file path, unless oyur specific like file_name, file_path etc.

=head3 Command Names

words separated by -

=head3 Event Names

words separated by .