[PATCH 1/2] tools: Add script to create artifacts

Adam Hassick ahassick at iol.unh.edu
Wed Jan 17 00:41:20 CET 2024


Yes, this makes sense. I've read through the Documentation
guidelines and have started writing a document for the tool.
However, I have a couple questions.

Where should the new document be created?
Also, should I create a "doc/api" directory and include files to
build the documentation?

On Tue, Jan 16, 2024 at 9:10 AM Aaron Conole <aconole at redhat.com> wrote:

> Adam Hassick <ahassick at iol.unh.edu> writes:
>
> > On Wed, Jan 10, 2024 at 11:54 AM Aaron Conole <aconole at redhat.com>
> wrote:
> >
> >  Adam Hassick <ahassick at iol.unh.edu> writes:
> >
> >  > This script takes in a URL to a series on Patchwork and emits a
> >  > tarball which may be used for running tests.
> >  >
> >  > Signed-off-by: Adam Hassick <ahassick at iol.unh.edu>
> >  > ---
> >
> >  Just a quick glance.
> >
> >  Is it possible to include a doc on how it is expected to run this
> >  script?  Maybe that could help to also evaluate it as well.
> >
> > Is there a location in or outside of this repository where
> > documentation on tools should be submitted? I have included
> > a brief description in the text displayed when the "--help" flag
> > is passed in, and in v2 this will include an example.
>
> I think just make a doc/ directory and add a .rst for this tool
> (something like we would do for manpages).  I know this is a new thing
> that we haven't required in the past, but the project is now growing to
> the point that we should have a bit of knowledge shared around.
>
> Does it make sense?
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mails.dpdk.org/archives/ci/attachments/20240116/41124c44/attachment.htm>


More information about the ci mailing list