RFC: Dealing with version-specific docs
Gabor Kovesdan
gabor at FreeBSD.org
Mon Jan 28 12:52:07 UTC 2013
Em 28-01-2013 13:15, Mehmet Erol Sanliturk escreveu:
> I think , the required effort for version specific Handbook is much
> less than multiple version covering Handbook , because , if any change
> is not applied to a prior version , which is mostly the case ,
> its Handbook will also not be modified .
> If a change is applied to a version and it is copied also to prior
> versions , the changes to the Handbook may also be copied to their
> Handbooks . This will not be difficult than to modify a multiple
> version contained Handbook .
>
> As a result , again my primary suggestion is to make the Handbook
> version specific : When a version is branched , its Handbook and
> related other documentation also should be branched and maintained
> with the related version .
Mehmet, thanks for the comments but I was interested in comments of that
very specific technical solution that I proposed on the linked wiki
page. The necessity of handling version-specific information has been
discussed several times both on the lists and on conferences so please
let's focus on technical solutions rather than going back to general
discussions. If you see the linked page, there was no branching
mentioned there, it is a much easier and simpler approach.
Gabor
More information about the freebsd-doc
mailing list