gitlab-ci-local icon indicating copy to clipboard operation
gitlab-ci-local copied to clipboard

Improve the documentation

Open antoinetavant opened this issue 1 year ago • 2 comments

First of all, thanks for your tool ! It works like a charme ! I hope I did not miss the documenation and that my issue is meaninfull.

Feature request

As a new user of just one day, I am looking for a more didactic documentation, with User guide, how-tos, etc.

The installation and the few examples of the Readme are great, but more can be added for new users (like myself)

Possible solutions

A documentation website hosted on ReadTheDocs or as a github page, including

  • details of the CLI parameters (API reference)
  • how-tos
  • Illustrations
  • Realeses
  • explainations of the examples already provided

Alternative solutions

The Gitlab wiki is a possible, as well as just providing markdow files in the project repository. It is simpler to manage, but less nice.

additional context

I'm willing to contribute to this Issue, But I never developed a documentation for TS projects. However, I'm used to document python projects with Sphinx.

antoinetavant avatar May 15 '24 11:05 antoinetavant

You are more than welcome, to give whatever tool or way you find suited a shot 👍 It will be merged, no doubt about it.

firecow avatar May 15 '24 20:05 firecow

https://vitepress.dev/ and https://rspress.dev/ are good options

hverlin avatar Jun 26 '24 11:06 hverlin

Since no attempts have been made to make an extensive documentation page, I'm closing this.

We will have to live with README.md :smile:

firecow avatar Nov 22 '24 18:11 firecow