[LTP] [PATCH v2 0/6] Release scripts and docs

[Li Wang]

Nice work!

I didn't verify the shell script work but generally looks good.
It should be safe to add those patches in the new release
as most changes focus on documentation.

Reviewed-by: Li Wang <liwang@redhat.com>


On Thu, Sep 28, 2023 at 4:21 AM Petr Vorel <pvorel@suse.cz> wrote:

> TL;DR
> * "LTP Release Procedure" wiki page is (temporarily) visible on:
> https://github.com/pevik/ltp/wiki/TEST
>
> NOTE due a public holiday in the Czech Republic tomorrow, I don't expect
> Cyril will have time to have look into this before release (which should
> be on Friday).
>
> Changes v1->v2:
> "LTP Release Procedure" wiki page
> * Create "1. Release preparations" paragraph, use Cyril's text for it.
> * Add section "2. Prepare the release notes" (important part as which takes
>   some time, thus deserve it's own section, 5th section with sending
>   announcement is of course kept).
> * Kept command examples (Li), update them (e.g. not pushing all tags,
>   but only one created - this can avoid pushing tags from forks - e.g.
>   from AOSP).
> * Mention tools/tag-release.sh tools/create-tarballs-metadata.sh scripts.
> * s/20230516/YYYYMMDD/ in wiki doc (previous tag kept as 20230127, Cyril).
>
> tools/tag-release.sh
> * Remove skeleton generation (Cyril).
>
> Other
> * resend "Remove Makefile.release" in this series.
> (it's separated, but let's remove it once we agree on this).
>
> Kind regards,
> Petr
>
> Petr Vorel (6):
>   tools: Add a script for tagging the release
>   tools: Add script for creating tarballs and metadata
>   doc: Rename files to names from ltp.wiki.git
>   doc: Add Release procedure
>   doc: Update release procedure
>   Remove Makefile.release
>
>  .github/workflows/wiki-mirror.yml             |  16 +-
>  Makefile.release                              |  46 -----
>  ...ild-system-guide.txt => Build-System.rest} |   0
>  doc/{c-test-api.txt => C-Test-API.asciidoc}   |   0
>  ...mple.txt => C-Test-Case-Tutorial.asciidoc} |   0
>  ...-c-api.txt => C-Test-Network-API.asciidoc} |   0
>  ...kvm-test-api.txt => KVM-Test-API.asciidoc} |   0
>  ...P-Library-API-Writing-Guidelines.asciidoc} |   0
>  doc/LTP-Release-Procedure.asciidoc            | 183 ++++++++++++++++++
>  ...aintainer-Patch-Review-Checklist.asciidoc} |   0
>  ...l-test-api.txt => Shell-Test-API.asciidoc} |   0
>  ...kernel,-libc,-toolchain-versions.asciidoc} |   0
>  ...s.txt => Test-Writing-Guidelines.asciidoc} |   0
>  ...ser-guide.txt => User-Guidelines.asciidoc} |   0
>  tools/create-tarballs-metadata.sh             |  56 ++++++
>  tools/lib.sh                                  |  31 +++
>  tools/tag-release.sh                          |  45 +++++
>  17 files changed, 318 insertions(+), 59 deletions(-)
>  delete mode 100644 Makefile.release
>  rename doc/{build-system-guide.txt => Build-System.rest} (100%)
>  rename doc/{c-test-api.txt => C-Test-API.asciidoc} (100%)
>  rename doc/{c-test-tutorial-simple.txt => C-Test-Case-Tutorial.asciidoc}
> (100%)
>  rename doc/{network-c-api.txt => C-Test-Network-API.asciidoc} (100%)
>  rename doc/{kvm-test-api.txt => KVM-Test-API.asciidoc} (100%)
>  rename doc/{library-api-writing-guidelines.txt =>
> LTP-Library-API-Writing-Guidelines.asciidoc} (100%)
>  create mode 100644 doc/LTP-Release-Procedure.asciidoc
>  rename doc/{maintainer-patch-review-checklist.txt =>
> Maintainer-Patch-Review-Checklist.asciidoc} (100%)
>  rename doc/{shell-test-api.txt => Shell-Test-API.asciidoc} (100%)
>  rename doc/{supported-kernel-libc-versions.txt =>
> Supported-kernel,-libc,-toolchain-versions.asciidoc} (100%)
>  rename doc/{test-writing-guidelines.txt =>
> Test-Writing-Guidelines.asciidoc} (100%)
>  rename doc/{user-guide.txt => User-Guidelines.asciidoc} (100%)
>  create mode 100755 tools/create-tarballs-metadata.sh
>  create mode 100755 tools/lib.sh
>  create mode 100755 tools/tag-release.sh
>
> --
> 2.40.1
>
>

-- 
Regards,
Li Wang