RFC: Dealing with version-specific docs
Gabor Kovesdan
gabor at FreeBSD.org
Mon Jan 28 15:47:43 UTC 2013
Em 28-01-2013 16:13, Warren Block escreveu:
> In other words:
>
> <para os="freebsd8">To do foobar, type bar.</para>
> <para os="freebsd9">To do foobar, type baz.</para>
>
> Could render as:
>
> FreeBSD 8.X:
> +-------------------------+
> | To do foobar, type bar. |
> +-------------------------+
>
> FreeBSD 9.X:
> +-------------------------+
> | To do foobar, type baz. |
> +-------------------------+
>
> Those could be in boxes or some other kind of visible mark, or maybe
> just in indented sections with titles. If it is not necessary to
> repeat the version information in two forms, then it can't be out of
> sync.
This is doable if we limit on what elements we use the conditions, e.g.
sect1-sect6, para, etc. But the number of elements should be limited,
otherwise it needs a heavy rewrite of the stylesheets.
>
> Are there other projects that have done this and whose experience
> could be useful?
I don't know about any but of course, there may be.
Gabor
More information about the freebsd-doc
mailing list