mbox series

[0/2] mmc-utils: Elaborate Documentation

Message ID 20240624112542.25657-1-avri.altman@wdc.com (mailing list archive)
Headers show
Series mmc-utils: Elaborate Documentation | expand

Message

Avri Altman June 24, 2024, 11:25 a.m. UTC
Here is an elaboration of documentations to pair up with the recent
addition of mmc-utils man page. It adds a public page:
https://mmc-utils.readthedocs.io/en/latest/.

Shamefully, I recently became aware that Marcus Folkesson already added
a man page quite some time ago, so this time I double-checked that
Read-the-Docs doesn't already have a mmc-utils page.

One thing that can greatly improve this page is an "examples" section.
A good practice would be for field application and validation engineers
that uses the tool daily to share their use-cases and practice.

Keeping the documentation page updated, I created a github repo to
mirror mmc-utils official repo and can be imported and re-built - 
https://github.com/avri-altman-wdc/mmc-utils.

Avri Altman (2):
  mmc-utils: Add documentation section
  mmc-utils: Add Read-the-Docs configuration

 .gitignore            |  1 +
 .readthedocs.yaml     | 17 ++++++++++
 Makefile              |  5 +++
 README                |  6 +++-
 docs/HOWTO.rst        | 67 ++++++++++++++++++++++++++++++++++++++
 docs/Makefile         | 20 ++++++++++++
 docs/README.rst       | 76 +++++++++++++++++++++++++++++++++++++++++++
 docs/conf.py          | 53 ++++++++++++++++++++++++++++++
 docs/index.rst        | 17 ++++++++++
 docs/requirements.txt |  2 ++
 10 files changed, 263 insertions(+), 1 deletion(-)
 create mode 100644 .readthedocs.yaml
 create mode 100644 docs/HOWTO.rst
 create mode 100644 docs/Makefile
 create mode 100644 docs/README.rst
 create mode 100644 docs/conf.py
 create mode 100644 docs/index.rst
 create mode 100644 docs/requirements.txt

Comments

Avri Altman July 7, 2024, 10:45 a.m. UTC | #1
A gentle ping.

Thanks,
Avri

> Here is an elaboration of documentations to pair up with the recent
> addition of mmc-utils man page. It adds a public page:
> https://mmc-utils.readthedocs.io/en/latest/.
> 
> Shamefully, I recently became aware that Marcus Folkesson already added
> a man page quite some time ago, so this time I double-checked that
> Read-the-Docs doesn't already have a mmc-utils page.
> 
> One thing that can greatly improve this page is an "examples" section.
> A good practice would be for field application and validation engineers
> that uses the tool daily to share their use-cases and practice.
> 
> Keeping the documentation page updated, I created a github repo to
> mirror mmc-utils official repo and can be imported and re-built -
> https://github.com/avri-altman-wdc/mmc-utils.
> 
> Avri Altman (2):
>   mmc-utils: Add documentation section
>   mmc-utils: Add Read-the-Docs configuration
> 
>  .gitignore            |  1 +
>  .readthedocs.yaml     | 17 ++++++++++
>  Makefile              |  5 +++
>  README                |  6 +++-
>  docs/HOWTO.rst        | 67 ++++++++++++++++++++++++++++++++++++++
>  docs/Makefile         | 20 ++++++++++++
>  docs/README.rst       | 76 +++++++++++++++++++++++++++++++++++++++++++
>  docs/conf.py          | 53 ++++++++++++++++++++++++++++++
>  docs/index.rst        | 17 ++++++++++
>  docs/requirements.txt |  2 ++
>  10 files changed, 263 insertions(+), 1 deletion(-)
>  create mode 100644 .readthedocs.yaml
>  create mode 100644 docs/HOWTO.rst
>  create mode 100644 docs/Makefile
>  create mode 100644 docs/README.rst
>  create mode 100644 docs/conf.py
>  create mode 100644 docs/index.rst
>  create mode 100644 docs/requirements.txt
> 
> --
> 2.34.1
Ulf Hansson July 8, 2024, 12:23 p.m. UTC | #2
On Mon, 24 Jun 2024 at 13:25, Avri Altman <avri.altman@wdc.com> wrote:
>
> Here is an elaboration of documentations to pair up with the recent
> addition of mmc-utils man page. It adds a public page:
> https://mmc-utils.readthedocs.io/en/latest/.
>
> Shamefully, I recently became aware that Marcus Folkesson already added
> a man page quite some time ago, so this time I double-checked that
> Read-the-Docs doesn't already have a mmc-utils page.
>
> One thing that can greatly improve this page is an "examples" section.
> A good practice would be for field application and validation engineers
> that uses the tool daily to share their use-cases and practice.
>
> Keeping the documentation page updated, I created a github repo to
> mirror mmc-utils official repo and can be imported and re-built -
> https://github.com/avri-altman-wdc/mmc-utils.
>
> Avri Altman (2):
>   mmc-utils: Add documentation section
>   mmc-utils: Add Read-the-Docs configuration
>
>  .gitignore            |  1 +
>  .readthedocs.yaml     | 17 ++++++++++
>  Makefile              |  5 +++
>  README                |  6 +++-
>  docs/HOWTO.rst        | 67 ++++++++++++++++++++++++++++++++++++++
>  docs/Makefile         | 20 ++++++++++++
>  docs/README.rst       | 76 +++++++++++++++++++++++++++++++++++++++++++
>  docs/conf.py          | 53 ++++++++++++++++++++++++++++++
>  docs/index.rst        | 17 ++++++++++
>  docs/requirements.txt |  2 ++
>  10 files changed, 263 insertions(+), 1 deletion(-)
>  create mode 100644 .readthedocs.yaml
>  create mode 100644 docs/HOWTO.rst
>  create mode 100644 docs/Makefile
>  create mode 100644 docs/README.rst
>  create mode 100644 docs/conf.py
>  create mode 100644 docs/index.rst
>  create mode 100644 docs/requirements.txt
>

Applied to git.kernel.org/pub/scm/utils/mmc/mmc-utils.git master, thanks!

Kind regards
Uffe