On Thu, Jan 12, 2017 at 04:18:58PM +0100, Michal Privoznik wrote:
On 01/12/2017 03:33 PM, Martin Kletzander wrote:
> On Thu, Jan 12, 2017 at 12:49:19PM +0100, Michal Privoznik wrote:
>> This element has been introduced in fe053dbea7, but isn't
>> documented yet. After exactly 6 years I guess we can finally
>> document it.
>>
>> Signed-off-by: Michal Privoznik <mprivozn(a)redhat.com>
>> ---
>> docs/formatdomain.html.in | 10 +++++++++-
>> 1 file changed, 9 insertions(+), 1 deletion(-)
>>
>
> ACK, trivial docs, safe for freeze. Do we really want to say the
> version there? =D
Well, I think that everything should say the version it was introduced
in. IMO by reading docs you should not only know how to enable the
feature but also whether your software is new enough to support the
feature in the first place. Another approach would be to have separate
docs per each release. Then we can drop <since/> entirely.
It was rather fun play on the fact that we're adding documentation for
something 107 releases after it was introduced, very specific to this
one. Of course I agree with the version mentioning in other cases.
Pushed. With the version mentioned :-) Thanks.
Michal