I've found that documentation packed into zip file of fuelphp source differs from online documentation. For instance take a look at documenation for database.
I think that latest online version of docs should be packed with every new release of fuel source.
This is already current practice. The docs aren't versioned like all the other repo's currently, which is why with each release we include a copy of the docs as it was at that point in time. While we continue to develop v1.0 we also update the docs and the docs on the site are a recent version which corresponds to the most recent version in develop - not the one in the ZIP. And that's why they are different versions.