[LTP] [RFC PATCH 1/1] doc: Split test-writing-guidelines

Cyril Hrubis chrubis@suse.cz
Thu May 27 14:28:41 CEST 2021


Hi!
> Test Writing Guidelines wiki page is too long, thus split it
> into 3 parts:
> 
> 1) generic part (only first chapter, the same URL)
> 2) C test API (2.2 chapter, 4. Common problems)
> 3) shell test API
> 
> Unfortunately this breaks users' bookmarks.
> 
> Start numbering in headers from 1 on each page (links are broken
> anyway).
> 
> NOTE: in order to have '...' formatting as code,
> main header ====== was needed to add on the page.

The split looks good to me, acked.

> Signed-off-by: Petr Vorel <pvorel@suse.cz>
> ---
> See it:
> https://github.com/pevik/ltp/wiki/Test-Writing-Guidelines

This page should be updated, at least the paragraph about commenting code
should now explain top level comment format.

The backward compatibility should be improved as well, since we have
kernel config parser now as well, etc.

I guess that I should sit down and write a patch for that one once the
split is applied.

-- 
Cyril Hrubis
chrubis@suse.cz


More information about the ltp mailing list