In preparation for the release of Logger 2.1.0 I've decided to write a few posts highlighting some of the new features.
As Logger
expands, so does its documentation. We have reached a point that it was
no longer feasible to continue with a one page documentation structure.
Besides being hard to find a specific bit of information I also found
that it was hard to get a quick overview of all the functions that
Logger has.
The documentation for Logger has been
completely revamped. It's broken up into two main sections: the initial
readme file (found on the main project page) and a wiki.
The readme file contains a brief overview of logger and links to the
wiki. The wiki has been broken up into four sub sections: Installation, Logger API, Change Log, and Best Practices.
This is a start to make Logger's documentation similar to Oracle's
documentation format which should make things consistent for developers.
If you've already used Logger for a while, take a look at the Logger API page. I think you'll find some functions that you didn't know existed.
The
wiki documents are stored in a separate repository on GitHub. This
means that they aren't synced with a release is tagged. To get around
this issue, each build now contains a folder called "wiki". In it, you
will find all the wiki files (in markdown format) generated at the time
of the build.
On a side note, the documentation
restructuring took a lot of time. I didn't have enough time to document
all the functions and they will all be updated in the near future once I
have more time. Of course you're encouraged to fork the project and
update the documentation if you want to help out.
No comments:
Post a Comment