Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New docs: Convert inline example code to use codeinclude macro #1158

Open
2 of 14 tasks
rnorth opened this issue Jan 19, 2019 · 2 comments
Open
2 of 14 tasks

New docs: Convert inline example code to use codeinclude macro #1158

rnorth opened this issue Jan 19, 2019 · 2 comments

Comments

@rnorth
Copy link
Member

rnorth commented Jan 19, 2019

Improvement for the new mkdocs-based documentation.

Aim to replace the majority of inline code blocks in the docs with codeinclude macros, so that our examples are compiled and tested as part of the build.

This doesn't need to all be done in one PR - it probably ought to be split.

Pages that would benefit from this (in no particular order):

  • docs/features/container_logs.md
  • docs/features/commands.md
  • docs/features/creating_container.md
  • docs/features/creating_images.md
  • docs/features/files.md
  • docs/modules/docker_compose.md
  • docs/modules/elasticsearch.md
  • docs/modules/kafka.md
  • docs/modules/vault.md
  • docs/modules/webdriver_containers.md
  • docs/test_framework_integration/junit_4.md
  • docs/test_framework_integration/junit_5.md
  • docs/test_framework_integration/spock.md
  • docs/supported_docker_environment/logging_config.md
@stale
Copy link

stale bot commented Apr 19, 2019

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. If you believe this is a mistake, please reply to this comment to keep it open. If there isn't one already, a PR to fix or at least reproduce the problem in a test case will always help us get back on track to tackle this.

@stale stale bot added the stale label Apr 19, 2019
raynigon referenced this issue in raynigon/testcontainers-java Jun 2, 2020
use codeinclude for the elasticsearch module documentation
raynigon referenced this issue in raynigon/testcontainers-java Jun 2, 2020
use codeinclude for the elasticsearch module documentation
raynigon referenced this issue in raynigon/testcontainers-java Jun 3, 2020
modify container tests to reflect the code previously embedded in the documentation
raynigon referenced this issue in raynigon/testcontainers-java Jun 23, 2020
Convert inline example code to use codeinclude macro for the kafka module documentation.
raynigon referenced this issue in raynigon/testcontainers-java Jun 23, 2020
Convert inline example code to use codeinclude macro for the Webdriver Containers documentation.
See #1158 for more details.
raynigon referenced this issue in raynigon/testcontainers-java Jun 23, 2020
Convert inline example code to use codeinclude macro for the Webdriver Containers documentation.
See #1158 for more details.

Fixed ChromeRecordingWebDriverContainerTest which was crashed by previous commit.
raynigon referenced this issue in raynigon/testcontainers-java Jun 23, 2020
Convert inline example code to use codeinclude macro for the Webdriver Containers documentation.
See #1158 for more details.

Fixed ChromeRecordingWebDriverContainerTest which was crashed by previous commit.
Fix Labels for RECORD_ALL, RECORD_FAILING enum values.
raynigon referenced this issue in raynigon/testcontainers-java Jun 23, 2020
Convert inline example code to use codeinclude macro for the Spock Testframework documentation.
See #1158 for more details.
@raynigon
Copy link
Contributor

raynigon commented Jun 23, 2020

Current State:

  • docs/modules/elasticsearch.md
  • docs/modules/kafka.md
  • docs/modules/webdriver_containers.md
  • docs/test_framework_integration/spock.md
  • docs/test_framework_integration/junit_5.md
  • docs/test_framework_integration/junit_4.md
  • docs/features/container_logs.md
  • docs/features/commands.md
  • docs/features/creating_container.md
  • docs/features/creating_images.md
  • docs/features/files.md
  • docs/modules/docker_compose.md
  • docs/modules/vault.md
  • docs/supported_docker_environment/logging_config.md

kiview pushed a commit that referenced this issue Jun 23, 2020
Convert inline example code to use codeinclude macro for the Spock Testframework documentation
See #1158 for more details.
rnorth pushed a commit that referenced this issue Jun 29, 2020
raynigon referenced this issue in raynigon/testcontainers-java Jul 6, 2020
Implement the codeinclude plugin for the junit5 docs
raynigon referenced this issue in raynigon/testcontainers-java Jul 27, 2020
raynigon referenced this issue in raynigon/testcontainers-java Jul 27, 2020
raynigon referenced this issue in raynigon/testcontainers-java Jul 27, 2020
raynigon referenced this issue in raynigon/testcontainers-java Jul 27, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants