Date: Wed, 30 Jan 2013 20:56:10 +0100 From: Gabor Kovesdan <gabor@FreeBSD.org> To: bcr@FreeBSD.org Cc: svn-doc-projects@FreeBSD.org, doc-committers@FreeBSD.org Subject: Re: svn commit: r40831 - in projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook: . preface Message-ID: <51097ADA.6050405@FreeBSD.org> In-Reply-To: <510977F0.2040106@FreeBSD.org> References: <201301301901.r0UJ1YY6051367@svn.freebsd.org> <51096FC6.2000205@FreeBSD.org> <510977F0.2040106@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Em 30-01-2013 20:43, Benedict Reuschling escreveu: > Well, there is the WITH_PGPKEYS variable that just uses the > fingerprints for the print version. I could revert the above change, > no problem. > > But what about other chapters? I'm working on removing the 8.x install > chapter in that branch since the print edition will only cover 9.x. > There are still many links to the old install chapter in many parts of > the handbook. I planned to update them all to point to the bsdinstall > chapter. However, it might make sense (not just for this chapter) to > just keep links to old chapters in the online version that are removed > in the print edition. I don't know how difficult it would be to add > such a profiling attribute to every such link, but I guess it would be. > > I'm in favour of a single source solution, especially for merges back > to the online version. Right now, we try to put all changes that make > sense to both head and the book branch. However, there are going to be > changes (like deleting non-9.x content) that will be made to the book > branch sooner while keeping it for the online handbook. Of course this > makes merging difficult later on. But my view on this is that at one > point the print edition will become the new online version of the > handbook, so everything that we delete now for the book will also be > deleted for the online edition. The PGPkeys chapter can be reactivated > easier than other changes. But I think we should discuss this now > before both the branch and the online edition drift further apart. > > I don't have a problem to revert the above change, though if that is > the consensus and a solution can be found that is easier to merge. It would be very easy, practically just putting an attribute to the varlistentry and the pgpkeys sect1, something like edition="online". I think we should think of future print editions and benefit from this tidying that we are doing now to make the infrastructure capable of dealing with this. If we maintain two branches and de- and reactivate things, it can easily lead to wasting manpower and forgetting things like post cleanup and putting things back to their places. I'm working on some serious changes towards real XML toolset in a branch and it is very easy to add a custom profiling attribute like edition. For the meantime to avoid deferring the cleanup work on the content, you could use an existing attribute, like condition="online" or condition="print". Later on we can go back and refine things. Any thoughts from others? Gabor
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?51097ADA.6050405>