Skip to content

Validate doc on pr#9293

Merged
ndeloof merged 5 commits intodocker:v2from
glours:validate-doc-on-pr
Mar 18, 2022
Merged

Validate doc on pr#9293
ndeloof merged 5 commits intodocker:v2from
glours:validate-doc-on-pr

Conversation

@glours
Copy link
Contributor

@glours glours commented Mar 16, 2022

What I did
To be sure we're always in sync between the code and the reference documentation, we added in the Makefile:

  • a command to generate the doc from a container
  • a command to check if the documentation is up to date or not

(not mandatory) A picture of a cute animal, if possible in relation with what you did
image

Signed-off-by: Guillaume Lours <guillaume.lours@docker.com>
@glours glours self-assigned this Mar 16, 2022
glours added 2 commits March 16, 2022 23:24
add docs validation (using same process a BuildX project)

Signed-off-by: Guillaume Lours <guillaume.lours@docker.com>
Signed-off-by: Guillaume Lours <guillaume.lours@docker.com>
@glours glours force-pushed the validate-doc-on-pr branch from 87fae73 to 572bd70 Compare March 16, 2022 22:24
shorthand: T
value_type: bool
default_value: "false"
default_value: "true"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks odd; is this because we're detecting if we're running with a TTY attached? Perhaps there should be no visible default (or the description needs to be updated to reflect that we're automatically detecting)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1 for documenting this in description

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Doc updated, thank you folks

Signed-off-by: Guillaume Lours <guillaume.lours@docker.com>
Makefile Outdated
.PHONY: docs
docs: ## generate documentation
@docker build . \
--output type=local,dest=./docs/ \
Copy link
Member

@crazy-max crazy-max Mar 17, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

output will not rsync so if some files are not their anymore they will still be in the working tree. I suggest to do smth like https://github.com/docker/cli/blob/11c76f1ddbb64e4d88b44b48c017b81ffe86e0e5/docker.Makefile#L84-L88

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done, thanks @crazy-max 🙏

Signed-off-by: Guillaume Lours <guillaume.lours@docker.com>
@glours glours force-pushed the validate-doc-on-pr branch from af7fdc1 to ada0283 Compare March 17, 2022 16:23
@glours glours requested review from crazy-max and thaJeztah March 18, 2022 09:04
Copy link
Member

@crazy-max crazy-max left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@ndeloof ndeloof merged commit be187ba into docker:v2 Mar 18, 2022
@glours glours deleted the validate-doc-on-pr branch January 11, 2023 14:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants