f.haeder.net

What nobody tells you about documentation

Daneiele Procida has given a speech about why good #documentation matters in your software. Watch the video at #peertube :

PeerTube: What nobody tells you about documentation (wat)



I think this just not applies on #Python exclusively but on all programming languages: document as much as you can.
#documentation #peertube #Python cplusplus documentation floss java perl php pycon python ruby

Finally committing and developing again

Finally I found some time to continue developing (at least a bit) on my upcoming FLOSS Java projects (do I have to add the class path exception here?) with entities (JPA), Enterprise Java Beans and JSF applications.

And I listen to #Psy-Trance . :-)

I have to commit a lot as I have not done that for several months. Now I review my changes and found here and there some bad things, like having "complex" methods in entity classes (you should better write an utility class for these methods and declare them static).

Really a lot stuff to do here. :-) I have many small projects as suggested by my trainer. Have small reusable "components" and not one big "core" that all have to include.
#Psy-Trance developing floss free-time
You have a trainer?
I was trained by a person that was talking and showing to me over a virtual class room. It were actually 3 professionals or "trainer" or "coaches", one for #Java basics and advanced course (still #JavaSE ) and one for #JavaEE basic and advance course and the third was last introduced to me for project management and I got best remarks everywhere. :-) Sure I don't know everything at a glance, in Java with 3 editions, this is next to impossible.

Maybe coach is the better word here?
This is pretty cool!
Good old classics again: #DNA - Illusions (The Music).
#DNA
"We'd been hit by an electromagnetic pulse." :-)

Rewrite of "core" framework basically done!

The huge rewrite is finally done. The application "tests" runs again without errors. I have rewritten the launch part of an application by rewriting many pre-deprecated sections and loosing about 5-7 include files (which is good for performance). "Detection" of the application's name (parameter: app) was very badly written, e.g. $_GET was checked again, even when there was already a Requestable instance around.

This is now finally done and I'm going to rewrite my application "hub" towards these changes. The #GIT repository is here:
#GIT core floss framework php7 rewrite
And remove discouraged ?> end-tag. ;-)
Turning 04:00 a.m. here, turning myself in.
Lot's of code moved and tons of "imported FooBar" and "created namespace" done, still a lot (of same) to do. Plus I need to rewrite socket-container stuff ... And more!
More stuff rewritten, like the socket container, now more methods are working, still a lot ahead.
Had been out to my wife's friend's family this day. Yesterday and this morning I continued to rewrote from direct socket resource (no type-hint possible in #PHP ) to socket container class, including interface (as usual for my programming).
#PHP
Next hard nut to crack: #UDP sockets "listening" on incoming "connections" (yes, I know, UDP is connection-less).
#UDP

Rewrites of framework almost done

Today I have almost finished rewriting my #object-oriented #PHP #framework (not to be confused with yet-another PHP web framework, no) towards #namespace. It took me 77 commits (as I commit not in big chunks anymore) to add namespaces and "import" classes/interfaces + expanding configuration entries with proper namespaces.

My next work will be rewrites in reducing include files in folder "inc", they come from old times where I was "encapsulating" stuff in include files, now I do it with classes and methods.

Still ongoing (or temporary postponed is the rewrite towards a "wrapper" (not following naming convention here!) class around sockets and the bootstrap.

BTW: You can find it here:
#object-oriented #PHP #framework #namespace core floss framework php5 php7
And pushed, tomorrow morning, around for an hour there will be no electricity here, they work on the cables outside and our house number is affected. So I shutdown my computer now (which will ruin the uptime again).

$ uptime
23:18:08 up 36 days, 3:21, 4 users, load average: 0.35, 0.55, 0.59
$


Good bye and until tomorrow! :-)
Looks like #gitweb is showing the committer's timestamp and not the author's. Well, that is why all changes has apparently been done on 2017-02-28 (which is not really true). Or maybe a rebase caused this?
newer older