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