Creating an Admin Handbook and Repo copy ?
Creating an Admin Handbook and Repo copy ?
I think the time has come to split up the Handbook. It has grown
unchecked for far too long and it has been several years since we last
moved chapters out of the Handbook (and into the Developers Handbook
in that case).
The Handbook is currently organized as 5 distinct DocBook
Without having looked closely into which parts go where, I think it
makes sense to do a split.I would suggest announcing the change a bit in advance and the doing a
freeze for commits to the handbook during the change, to avoid making it
more difficualt than necessary.Since a lot of people expect just to look in the "Handbook" and people
have have direct links into to it, I think the notice of the change
should be published so as many people as possible get the heads up.
Perhaps even on announce@.
Since there exist quite a lot of links directly into the Handbook, I
think it would be a good idea to create dummy HTML files, for the
section that's going to be moved. They would tell people that the
Handbook has been split, and refresh after 10 seconds to the new page,
instead of giving people a 404 error. I think it should be fairly
trivial to auto generate those HTML files. It would require doing
something special with for the build dir on www.FreeBSD.org, but I think
it's worth it to avoid confusing users with dead links.