From eaada52983ecaab38bd03871ba66d671736dff5d Mon Sep 17 00:00:00 2001 From: quinntaylormitchell Date: Mon, 4 Aug 2025 16:29:20 +0000 Subject: [PATCH 1/4] Rename 'user-guide' and 'dev-guide' directories to 'user-docs' and 'dev-docs' respectively; modify all references to these directories --- README.md | 8 ++++---- .../clp-py-utils/clp_py_utils/clp_metadata_db_utils.py | 2 +- components/core/README.md | 4 ++-- .../core/src/clp/ffi/search/CompositeWildcardToken.cpp | 2 +- .../core/src/glt/ffi/search/CompositeWildcardToken.cpp | 2 +- components/package-template/src/README.md | 2 +- components/webui/README.md | 2 +- docs/src/{dev-guide => dev-docs}/building-package.md | 0 .../components-core/centos-stream-9-deps-install.md | 0 .../{dev-guide => dev-docs}/components-core/index.md | 0 .../components-core/macos-deps-install.md | 0 .../components-core/regex-utils.md | 0 .../components-core/ubuntu-jammy-deps-install.md | 0 docs/src/{dev-guide => dev-docs}/components-webui.md | 0 .../contributing-getting-started.md | 0 .../{dev-guide => dev-docs}/contributing-linting.md | 0 .../design-kv-ir-streams/auto-gen-kv-pairs.md | 0 .../design-kv-ir-streams/background.md | 4 ++-- .../design-kv-ir-streams/index.md | 0 docs/src/{dev-guide => dev-docs}/design-metadata-db.md | 0 .../design-parsing-wildcard-queries.md | 0 .../design-project-structure.md | 0 docs/src/{dev-guide => dev-docs}/index.md | 0 docs/src/{dev-guide => dev-docs}/tooling-containers.md | 0 .../{dev-guide => dev-docs}/tooling-gh-workflows.md | 0 docs/src/index.md | 10 +++++----- docs/src/{user-guide => user-docs}/core-clp-s.md | 0 docs/src/{user-guide => user-docs}/core-container.md | 0 docs/src/{user-guide => user-docs}/core-overview.md | 0 .../{user-guide => user-docs}/core-unstructured/clp.md | 0 .../{user-guide => user-docs}/core-unstructured/glt.md | 0 .../core-unstructured/index.md | 0 .../core-unstructured/make-dictionaries-readable.md | 0 .../src/{user-guide => user-docs}/guides-multi-node.md | 0 docs/src/{user-guide => user-docs}/guides-overview.md | 0 .../guides-using-object-storage/clp-config.md | 0 .../guides-using-object-storage/clp-usage.md | 0 .../guides-using-object-storage/index.md | 0 .../object-storage-config.md | 0 .../{user-guide => user-docs}/guides-using-presto.md | 0 docs/src/{user-guide => user-docs}/index.md | 0 .../quick-start/clp-json-search-ui.png | 0 .../{user-guide => user-docs}/quick-start/clp-json.md | 0 .../quick-start/clp-text-search-ui.png | 0 .../{user-guide => user-docs}/quick-start/clp-text.md | 0 .../src/{user-guide => user-docs}/quick-start/index.md | 0 .../reference-json-search-syntax.md | 0 .../reference-text-search-syntax.md | 0 .../reference-unstructured-schema-file.md | 0 .../{user-guide => user-docs}/resources-datasets.md | 0 50 files changed, 18 insertions(+), 18 deletions(-) rename docs/src/{dev-guide => dev-docs}/building-package.md (100%) rename docs/src/{dev-guide => dev-docs}/components-core/centos-stream-9-deps-install.md (100%) rename docs/src/{dev-guide => dev-docs}/components-core/index.md (100%) rename docs/src/{dev-guide => dev-docs}/components-core/macos-deps-install.md (100%) rename docs/src/{dev-guide => dev-docs}/components-core/regex-utils.md (100%) rename docs/src/{dev-guide => dev-docs}/components-core/ubuntu-jammy-deps-install.md (100%) rename docs/src/{dev-guide => dev-docs}/components-webui.md (100%) rename docs/src/{dev-guide => dev-docs}/contributing-getting-started.md (100%) rename docs/src/{dev-guide => dev-docs}/contributing-linting.md (100%) rename docs/src/{dev-guide => dev-docs}/design-kv-ir-streams/auto-gen-kv-pairs.md (100%) rename docs/src/{dev-guide => dev-docs}/design-kv-ir-streams/background.md (98%) rename docs/src/{dev-guide => dev-docs}/design-kv-ir-streams/index.md (100%) rename docs/src/{dev-guide => dev-docs}/design-metadata-db.md (100%) rename docs/src/{dev-guide => dev-docs}/design-parsing-wildcard-queries.md (100%) rename docs/src/{dev-guide => dev-docs}/design-project-structure.md (100%) rename docs/src/{dev-guide => dev-docs}/index.md (100%) rename docs/src/{dev-guide => dev-docs}/tooling-containers.md (100%) rename docs/src/{dev-guide => dev-docs}/tooling-gh-workflows.md (100%) rename docs/src/{user-guide => user-docs}/core-clp-s.md (100%) rename docs/src/{user-guide => user-docs}/core-container.md (100%) rename docs/src/{user-guide => user-docs}/core-overview.md (100%) rename docs/src/{user-guide => user-docs}/core-unstructured/clp.md (100%) rename docs/src/{user-guide => user-docs}/core-unstructured/glt.md (100%) rename docs/src/{user-guide => user-docs}/core-unstructured/index.md (100%) rename docs/src/{user-guide => user-docs}/core-unstructured/make-dictionaries-readable.md (100%) rename docs/src/{user-guide => user-docs}/guides-multi-node.md (100%) rename docs/src/{user-guide => user-docs}/guides-overview.md (100%) rename docs/src/{user-guide => user-docs}/guides-using-object-storage/clp-config.md (100%) rename docs/src/{user-guide => user-docs}/guides-using-object-storage/clp-usage.md (100%) rename docs/src/{user-guide => user-docs}/guides-using-object-storage/index.md (100%) rename docs/src/{user-guide => user-docs}/guides-using-object-storage/object-storage-config.md (100%) rename docs/src/{user-guide => user-docs}/guides-using-presto.md (100%) rename docs/src/{user-guide => user-docs}/index.md (100%) rename docs/src/{user-guide => user-docs}/quick-start/clp-json-search-ui.png (100%) rename docs/src/{user-guide => user-docs}/quick-start/clp-json.md (100%) rename docs/src/{user-guide => user-docs}/quick-start/clp-text-search-ui.png (100%) rename docs/src/{user-guide => user-docs}/quick-start/clp-text.md (100%) rename docs/src/{user-guide => user-docs}/quick-start/index.md (100%) rename docs/src/{user-guide => user-docs}/reference-json-search-syntax.md (100%) rename docs/src/{user-guide => user-docs}/reference-text-search-syntax.md (100%) rename docs/src/{user-guide => user-docs}/reference-unstructured-schema-file.md (100%) rename docs/src/{user-guide => user-docs}/resources-datasets.md (100%) diff --git a/README.md b/README.md index 39d9be5a4f..17d1e10b57 100644 --- a/README.md +++ b/README.md @@ -99,16 +99,16 @@ If you would like a feature or want to report a bug, please file an issue and we [badge-discord]: https://img.shields.io/discord/1377353873068392580?style=flat&logo=discord&logoColor=white&label=Discord&labelColor=%235561f5 [badge-zulip]: https://img.shields.io/badge/Zulip-yscope--clp-1888FA?logo=zulip [bug-report]: https://github.com/y-scope/clp/issues/new?assignees=&labels=bug&template=bug-report.yml -[build-package]: http://docs.yscope.com/clp/main/dev-guide/building-package +[build-package]: http://docs.yscope.com/clp/main/dev-docs/building-package [clp-docs]: https://docs.yscope.com/clp/main [clp-ffi-go]: https://github.com/y-scope/clp-ffi-go [clp-ffi-py]: https://github.com/y-scope/clp-ffi-py [clp-loglib-py]: https://github.com/y-scope/clp-loglib-py [clp-paper-21]: https://www.usenix.org/system/files/osdi21-rodrigues.pdf [clp-paper-24]: https://www.usenix.org/system/files/osdi24-wang-rui.pdf -[core]: http://docs.yscope.com/clp/main/dev-guide/components-core -[core-container]: http://docs.yscope.com/clp/main/user-guide/core-container -[datasets]: https://docs.yscope.com/clp/main/user-guide/resources-datasets +[core]: http://docs.yscope.com/clp/main/dev-docs/components-core +[core-container]: http://docs.yscope.com/clp/main/user-docs/core-container +[datasets]: https://docs.yscope.com/clp/main/user-docs/resources-datasets [feature-req]: https://github.com/y-scope/clp/issues/new?assignees=&labels=enhancement&template=feature-request.yml [log-surgeon]: https://github.com/y-scope/log-surgeon [log-viewer]: https://github.com/y-scope/yscope-log-viewer diff --git a/components/clp-py-utils/clp_py_utils/clp_metadata_db_utils.py b/components/clp-py-utils/clp_py_utils/clp_metadata_db_utils.py index 17855728c9..eaab5e1078 100644 --- a/components/clp-py-utils/clp_py_utils/clp_metadata_db_utils.py +++ b/components/clp-py-utils/clp_py_utils/clp_metadata_db_utils.py @@ -133,7 +133,7 @@ def create_datasets_table(db_cursor, table_prefix: str) -> None: """ # For a description of the table, see - # `../../../docs/src/dev-guide/design-metadata-db.md` + # `../../../docs/src/dev-docs/design-metadata-db.md` db_cursor.execute( f""" CREATE TABLE IF NOT EXISTS `{get_datasets_table_name(table_prefix)}` ( diff --git a/components/core/README.md b/components/core/README.md index b947f4b9c5..5f097db2f9 100644 --- a/components/core/README.md +++ b/components/core/README.md @@ -4,5 +4,5 @@ CLP core is the low-level component that performs compression, decompression, an See the docs below for more details: -* [Building](https://docs.yscope.com/clp/main/dev-guide/components-core) -* [Running](https://docs.yscope.com/clp/main/user-guide/core-overview) +* [Building](https://docs.yscope.com/clp/main/dev-docs/components-core) +* [Running](https://docs.yscope.com/clp/main/user-docs/core-overview) diff --git a/components/core/src/clp/ffi/search/CompositeWildcardToken.cpp b/components/core/src/clp/ffi/search/CompositeWildcardToken.cpp index b36126ebd6..8fc0845e32 100644 --- a/components/core/src/clp/ffi/search/CompositeWildcardToken.cpp +++ b/components/core/src/clp/ffi/search/CompositeWildcardToken.cpp @@ -139,7 +139,7 @@ bool CompositeWildcardToken::generate_next_interpretation() * into two tokens at the delimiter. * - Finally, if a WildcardToken is delimited by a '*'-delimiter-wildcard, then the '*' should be * included in the WildcardToken (see the generalization in - * /dev-guide/design-parsing-wildcard-queries). + * /dev-docs/design-parsing-wildcard-queries). * * Algorithm: * - To implement this algorithm, we need to search the CompositeWildcardToken for every substring diff --git a/components/core/src/glt/ffi/search/CompositeWildcardToken.cpp b/components/core/src/glt/ffi/search/CompositeWildcardToken.cpp index b8194e4b25..8ddf1c9e58 100644 --- a/components/core/src/glt/ffi/search/CompositeWildcardToken.cpp +++ b/components/core/src/glt/ffi/search/CompositeWildcardToken.cpp @@ -139,7 +139,7 @@ bool CompositeWildcardToken::generate_next_interpretation() * into two tokens at the delimiter. * - Finally, if a WildcardToken is delimited by a '*'-delimiter-wildcard, then the '*' should be * included in the WildcardToken (see the generalization in - * /dev-guide/design-parsing-wildcard-queries). + * /dev-docs/design-parsing-wildcard-queries). * * Algorithm: * - To implement this algorithm, we need to search the CompositeWildcardToken for every substring diff --git a/components/package-template/src/README.md b/components/package-template/src/README.md index 173f9d927d..23bd77d30a 100644 --- a/components/package-template/src/README.md +++ b/components/package-template/src/README.md @@ -5,4 +5,4 @@ compressed data without decompression. CLP's compression ratio is significantly general-purpose compressors like gzip. For setup and usage instructions, see -https://docs.yscope.com/clp/main/user-guide/quick-start-overview +https://docs.yscope.com/clp/main/user-docs/quick-start-overview diff --git a/components/webui/README.md b/components/webui/README.md index 299000819d..4d9f6428e0 100644 --- a/components/webui/README.md +++ b/components/webui/README.md @@ -4,4 +4,4 @@ The web interface for the CLP package. See the [docs] for more details. -[docs]: https://docs.yscope.com/clp/main/dev-guide/components-webui +[docs]: https://docs.yscope.com/clp/main/dev-docs/components-webui diff --git a/docs/src/dev-guide/building-package.md b/docs/src/dev-docs/building-package.md similarity index 100% rename from docs/src/dev-guide/building-package.md rename to docs/src/dev-docs/building-package.md diff --git a/docs/src/dev-guide/components-core/centos-stream-9-deps-install.md b/docs/src/dev-docs/components-core/centos-stream-9-deps-install.md similarity index 100% rename from docs/src/dev-guide/components-core/centos-stream-9-deps-install.md rename to docs/src/dev-docs/components-core/centos-stream-9-deps-install.md diff --git a/docs/src/dev-guide/components-core/index.md b/docs/src/dev-docs/components-core/index.md similarity index 100% rename from docs/src/dev-guide/components-core/index.md rename to docs/src/dev-docs/components-core/index.md diff --git a/docs/src/dev-guide/components-core/macos-deps-install.md b/docs/src/dev-docs/components-core/macos-deps-install.md similarity index 100% rename from docs/src/dev-guide/components-core/macos-deps-install.md rename to docs/src/dev-docs/components-core/macos-deps-install.md diff --git a/docs/src/dev-guide/components-core/regex-utils.md b/docs/src/dev-docs/components-core/regex-utils.md similarity index 100% rename from docs/src/dev-guide/components-core/regex-utils.md rename to docs/src/dev-docs/components-core/regex-utils.md diff --git a/docs/src/dev-guide/components-core/ubuntu-jammy-deps-install.md b/docs/src/dev-docs/components-core/ubuntu-jammy-deps-install.md similarity index 100% rename from docs/src/dev-guide/components-core/ubuntu-jammy-deps-install.md rename to docs/src/dev-docs/components-core/ubuntu-jammy-deps-install.md diff --git a/docs/src/dev-guide/components-webui.md b/docs/src/dev-docs/components-webui.md similarity index 100% rename from docs/src/dev-guide/components-webui.md rename to docs/src/dev-docs/components-webui.md diff --git a/docs/src/dev-guide/contributing-getting-started.md b/docs/src/dev-docs/contributing-getting-started.md similarity index 100% rename from docs/src/dev-guide/contributing-getting-started.md rename to docs/src/dev-docs/contributing-getting-started.md diff --git a/docs/src/dev-guide/contributing-linting.md b/docs/src/dev-docs/contributing-linting.md similarity index 100% rename from docs/src/dev-guide/contributing-linting.md rename to docs/src/dev-docs/contributing-linting.md diff --git a/docs/src/dev-guide/design-kv-ir-streams/auto-gen-kv-pairs.md b/docs/src/dev-docs/design-kv-ir-streams/auto-gen-kv-pairs.md similarity index 100% rename from docs/src/dev-guide/design-kv-ir-streams/auto-gen-kv-pairs.md rename to docs/src/dev-docs/design-kv-ir-streams/auto-gen-kv-pairs.md diff --git a/docs/src/dev-guide/design-kv-ir-streams/background.md b/docs/src/dev-docs/design-kv-ir-streams/background.md similarity index 98% rename from docs/src/dev-guide/design-kv-ir-streams/background.md rename to docs/src/dev-docs/design-kv-ir-streams/background.md index b7a86a21b3..9f8230b1bb 100644 --- a/docs/src/dev-guide/design-kv-ir-streams/background.md +++ b/docs/src/dev-docs/design-kv-ir-streams/background.md @@ -11,7 +11,7 @@ We discuss each below. ## clp-s compression -At a high-level, [clp-s](../../user-guide/core-clp-s.md) compresses log events into what we call +At a high-level, [clp-s](../../user-docs/core-clp-s.md) compresses log events into what we call archives. Depending on the configured size-threshold for each archive, a set of log events may be compressed into one or more archives. The archive format is designed so that each archive is self-contained and independent, allowing archives to be searched concurrently. @@ -318,7 +318,7 @@ the archive is complete. ## Parsing & encoding unstructured text -clp-s uses [clp](../../user-guide/core-unstructured/clp.md)'s algorithm to parse and encode +clp-s uses [clp](../../user-docs/core-unstructured/clp.md)'s algorithm to parse and encode unstructured text. Unstructured text is a string that contains zero or more variable values interspersed with non-variable (static) text. For example, in [Figure 1](#figure-1), log event #1's `message` value is unstructured text containing the variable values `task_1` and `2`. At a diff --git a/docs/src/dev-guide/design-kv-ir-streams/index.md b/docs/src/dev-docs/design-kv-ir-streams/index.md similarity index 100% rename from docs/src/dev-guide/design-kv-ir-streams/index.md rename to docs/src/dev-docs/design-kv-ir-streams/index.md diff --git a/docs/src/dev-guide/design-metadata-db.md b/docs/src/dev-docs/design-metadata-db.md similarity index 100% rename from docs/src/dev-guide/design-metadata-db.md rename to docs/src/dev-docs/design-metadata-db.md diff --git a/docs/src/dev-guide/design-parsing-wildcard-queries.md b/docs/src/dev-docs/design-parsing-wildcard-queries.md similarity index 100% rename from docs/src/dev-guide/design-parsing-wildcard-queries.md rename to docs/src/dev-docs/design-parsing-wildcard-queries.md diff --git a/docs/src/dev-guide/design-project-structure.md b/docs/src/dev-docs/design-project-structure.md similarity index 100% rename from docs/src/dev-guide/design-project-structure.md rename to docs/src/dev-docs/design-project-structure.md diff --git a/docs/src/dev-guide/index.md b/docs/src/dev-docs/index.md similarity index 100% rename from docs/src/dev-guide/index.md rename to docs/src/dev-docs/index.md diff --git a/docs/src/dev-guide/tooling-containers.md b/docs/src/dev-docs/tooling-containers.md similarity index 100% rename from docs/src/dev-guide/tooling-containers.md rename to docs/src/dev-docs/tooling-containers.md diff --git a/docs/src/dev-guide/tooling-gh-workflows.md b/docs/src/dev-docs/tooling-gh-workflows.md similarity index 100% rename from docs/src/dev-guide/tooling-gh-workflows.md rename to docs/src/dev-docs/tooling-gh-workflows.md diff --git a/docs/src/index.md b/docs/src/index.md index e1f719d640..d6ee213a95 100644 --- a/docs/src/index.md +++ b/docs/src/index.md @@ -77,14 +77,14 @@ Check out the relevant guide below, based on whether you'd like to use or develo :gutter: 2 :::{grid-item-card} -:link: user-guide/index +:link: user-docs/index User guide ^^^ Docs for those interested in using and operating CLP. ::: :::{grid-item-card} -:link: dev-guide/index +:link: dev-docs/index Developer guide ^^^ Docs for those interested in developing CLP. @@ -107,8 +107,8 @@ Need help? Join us on one of our community servers: :::{toctree} :hidden: -user-guide/index -dev-guide/index +user-docs/index +dev-docs/index ::: [badge-discord]: https://img.shields.io/discord/1377353873068392580?style=flat&logo=discord&logoColor=white&label=Discord&labelColor=%235561f5 @@ -118,7 +118,7 @@ dev-guide/index [clp-ffi-py]: https://github.com/y-scope/clp-ffi-py [clp-loglib-py]: https://github.com/y-scope/clp-loglib-py [clp-paper]: https://www.usenix.org/system/files/osdi21-rodrigues.pdf -[datasets]: user-guide/resources-datasets +[datasets]: user-docs/resources-datasets [feature-req]: https://github.com/y-scope/clp/issues/new?assignees=&labels=enhancement&template=feature-request.yml [log-surgeon]: https://github.com/y-scope/log-surgeon [log-viewer]: https://github.com/y-scope/yscope-log-viewer diff --git a/docs/src/user-guide/core-clp-s.md b/docs/src/user-docs/core-clp-s.md similarity index 100% rename from docs/src/user-guide/core-clp-s.md rename to docs/src/user-docs/core-clp-s.md diff --git a/docs/src/user-guide/core-container.md b/docs/src/user-docs/core-container.md similarity index 100% rename from docs/src/user-guide/core-container.md rename to docs/src/user-docs/core-container.md diff --git a/docs/src/user-guide/core-overview.md b/docs/src/user-docs/core-overview.md similarity index 100% rename from docs/src/user-guide/core-overview.md rename to docs/src/user-docs/core-overview.md diff --git a/docs/src/user-guide/core-unstructured/clp.md b/docs/src/user-docs/core-unstructured/clp.md similarity index 100% rename from docs/src/user-guide/core-unstructured/clp.md rename to docs/src/user-docs/core-unstructured/clp.md diff --git a/docs/src/user-guide/core-unstructured/glt.md b/docs/src/user-docs/core-unstructured/glt.md similarity index 100% rename from docs/src/user-guide/core-unstructured/glt.md rename to docs/src/user-docs/core-unstructured/glt.md diff --git a/docs/src/user-guide/core-unstructured/index.md b/docs/src/user-docs/core-unstructured/index.md similarity index 100% rename from docs/src/user-guide/core-unstructured/index.md rename to docs/src/user-docs/core-unstructured/index.md diff --git a/docs/src/user-guide/core-unstructured/make-dictionaries-readable.md b/docs/src/user-docs/core-unstructured/make-dictionaries-readable.md similarity index 100% rename from docs/src/user-guide/core-unstructured/make-dictionaries-readable.md rename to docs/src/user-docs/core-unstructured/make-dictionaries-readable.md diff --git a/docs/src/user-guide/guides-multi-node.md b/docs/src/user-docs/guides-multi-node.md similarity index 100% rename from docs/src/user-guide/guides-multi-node.md rename to docs/src/user-docs/guides-multi-node.md diff --git a/docs/src/user-guide/guides-overview.md b/docs/src/user-docs/guides-overview.md similarity index 100% rename from docs/src/user-guide/guides-overview.md rename to docs/src/user-docs/guides-overview.md diff --git a/docs/src/user-guide/guides-using-object-storage/clp-config.md b/docs/src/user-docs/guides-using-object-storage/clp-config.md similarity index 100% rename from docs/src/user-guide/guides-using-object-storage/clp-config.md rename to docs/src/user-docs/guides-using-object-storage/clp-config.md diff --git a/docs/src/user-guide/guides-using-object-storage/clp-usage.md b/docs/src/user-docs/guides-using-object-storage/clp-usage.md similarity index 100% rename from docs/src/user-guide/guides-using-object-storage/clp-usage.md rename to docs/src/user-docs/guides-using-object-storage/clp-usage.md diff --git a/docs/src/user-guide/guides-using-object-storage/index.md b/docs/src/user-docs/guides-using-object-storage/index.md similarity index 100% rename from docs/src/user-guide/guides-using-object-storage/index.md rename to docs/src/user-docs/guides-using-object-storage/index.md diff --git a/docs/src/user-guide/guides-using-object-storage/object-storage-config.md b/docs/src/user-docs/guides-using-object-storage/object-storage-config.md similarity index 100% rename from docs/src/user-guide/guides-using-object-storage/object-storage-config.md rename to docs/src/user-docs/guides-using-object-storage/object-storage-config.md diff --git a/docs/src/user-guide/guides-using-presto.md b/docs/src/user-docs/guides-using-presto.md similarity index 100% rename from docs/src/user-guide/guides-using-presto.md rename to docs/src/user-docs/guides-using-presto.md diff --git a/docs/src/user-guide/index.md b/docs/src/user-docs/index.md similarity index 100% rename from docs/src/user-guide/index.md rename to docs/src/user-docs/index.md diff --git a/docs/src/user-guide/quick-start/clp-json-search-ui.png b/docs/src/user-docs/quick-start/clp-json-search-ui.png similarity index 100% rename from docs/src/user-guide/quick-start/clp-json-search-ui.png rename to docs/src/user-docs/quick-start/clp-json-search-ui.png diff --git a/docs/src/user-guide/quick-start/clp-json.md b/docs/src/user-docs/quick-start/clp-json.md similarity index 100% rename from docs/src/user-guide/quick-start/clp-json.md rename to docs/src/user-docs/quick-start/clp-json.md diff --git a/docs/src/user-guide/quick-start/clp-text-search-ui.png b/docs/src/user-docs/quick-start/clp-text-search-ui.png similarity index 100% rename from docs/src/user-guide/quick-start/clp-text-search-ui.png rename to docs/src/user-docs/quick-start/clp-text-search-ui.png diff --git a/docs/src/user-guide/quick-start/clp-text.md b/docs/src/user-docs/quick-start/clp-text.md similarity index 100% rename from docs/src/user-guide/quick-start/clp-text.md rename to docs/src/user-docs/quick-start/clp-text.md diff --git a/docs/src/user-guide/quick-start/index.md b/docs/src/user-docs/quick-start/index.md similarity index 100% rename from docs/src/user-guide/quick-start/index.md rename to docs/src/user-docs/quick-start/index.md diff --git a/docs/src/user-guide/reference-json-search-syntax.md b/docs/src/user-docs/reference-json-search-syntax.md similarity index 100% rename from docs/src/user-guide/reference-json-search-syntax.md rename to docs/src/user-docs/reference-json-search-syntax.md diff --git a/docs/src/user-guide/reference-text-search-syntax.md b/docs/src/user-docs/reference-text-search-syntax.md similarity index 100% rename from docs/src/user-guide/reference-text-search-syntax.md rename to docs/src/user-docs/reference-text-search-syntax.md diff --git a/docs/src/user-guide/reference-unstructured-schema-file.md b/docs/src/user-docs/reference-unstructured-schema-file.md similarity index 100% rename from docs/src/user-guide/reference-unstructured-schema-file.md rename to docs/src/user-docs/reference-unstructured-schema-file.md diff --git a/docs/src/user-guide/resources-datasets.md b/docs/src/user-docs/resources-datasets.md similarity index 100% rename from docs/src/user-guide/resources-datasets.md rename to docs/src/user-docs/resources-datasets.md From a4c2471b291255eff090ec634abd5ae8b1aac325 Mon Sep 17 00:00:00 2001 From: quinntaylormitchell Date: Mon, 4 Aug 2025 17:13:53 +0000 Subject: [PATCH 2/4] Rabbit/Lint --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 17d1e10b57..84c10db0f8 100644 --- a/README.md +++ b/README.md @@ -105,7 +105,7 @@ If you would like a feature or want to report a bug, please file an issue and we [clp-ffi-py]: https://github.com/y-scope/clp-ffi-py [clp-loglib-py]: https://github.com/y-scope/clp-loglib-py [clp-paper-21]: https://www.usenix.org/system/files/osdi21-rodrigues.pdf -[clp-paper-24]: https://www.usenix.org/system/files/osdi24-wang-rui.pdf +[clp-paper-24]: https://www.usenix.org/system/files/osdi24-wang-rui.pdf [core]: http://docs.yscope.com/clp/main/dev-docs/components-core [core-container]: http://docs.yscope.com/clp/main/user-docs/core-container [datasets]: https://docs.yscope.com/clp/main/user-docs/resources-datasets From ab4934f93c35ff10a0c0de929c63ddfd613b355e Mon Sep 17 00:00:00 2001 From: quinntaylormitchell Date: Mon, 25 Aug 2025 16:50:15 +0000 Subject: [PATCH 3/4] Change text references to 'docs' as well --- docs/src/dev-docs/index.md | 4 ++-- docs/src/index.md | 6 +++--- docs/src/user-docs/core-overview.md | 2 +- docs/src/user-docs/index.md | 4 ++-- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/src/dev-docs/index.md b/docs/src/dev-docs/index.md index ae892e5707..2eaddd9e60 100644 --- a/docs/src/dev-docs/index.md +++ b/docs/src/dev-docs/index.md @@ -1,6 +1,6 @@ -# Developer guide +# Developer docs -This guide contains docs useful for developing CLP. Use the left sidebar (if it's hidden, click the +These docs are useful for developing CLP. Use the left sidebar (if it's hidden, click the icon) to navigate to specific docs. The sections are as follows: diff --git a/docs/src/index.md b/docs/src/index.md index d6ee213a95..15be6ad875 100644 --- a/docs/src/index.md +++ b/docs/src/index.md @@ -71,21 +71,21 @@ features: # Getting started -Check out the relevant guide below, based on whether you'd like to use or develop CLP. +Check out the relevant docs below, based on whether you'd like to use or develop CLP. ::::{grid} 1 1 2 2 :gutter: 2 :::{grid-item-card} :link: user-docs/index -User guide +User docs ^^^ Docs for those interested in using and operating CLP. ::: :::{grid-item-card} :link: dev-docs/index -Developer guide +Developer docs ^^^ Docs for those interested in developing CLP. ::: diff --git a/docs/src/user-docs/core-overview.md b/docs/src/user-docs/core-overview.md index c8cdd9a312..956ec5f952 100644 --- a/docs/src/user-docs/core-overview.md +++ b/docs/src/user-docs/core-overview.md @@ -3,7 +3,7 @@ CLP's core component contains the core code to compress, decompress, and search compressed logs. You can use it to try CLP on your logs before deploying a cluster. -There are currently two flavours of CLP, depending on the format of your logs. The guides below +There are currently two flavours of CLP, depending on the format of your logs. The docs below explain how to use each flavour. ::::{grid} 1 1 2 2 diff --git a/docs/src/user-docs/index.md b/docs/src/user-docs/index.md index ad3cfa916e..724d4ee26f 100644 --- a/docs/src/user-docs/index.md +++ b/docs/src/user-docs/index.md @@ -1,6 +1,6 @@ -# User guide +# User docs -This guide documents how to use and operate CLP. Use the left sidebar (if it's hidden, click the +These docs explain how to use and operate CLP. Use the left sidebar (if it's hidden, click the icon) to navigate to specific docs. The sections are as follows: From 05b9d62f8c2db64696c7242750ab4e528e65be87 Mon Sep 17 00:00:00 2001 From: Quinn Taylor Mitchell Date: Mon, 25 Aug 2025 13:59:52 -0400 Subject: [PATCH 4/4] Update docs/src/dev-docs/index.md Co-authored-by: kirkrodrigues <2454684+kirkrodrigues@users.noreply.github.com> --- docs/src/dev-docs/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/src/dev-docs/index.md b/docs/src/dev-docs/index.md index 2eaddd9e60..5372121755 100644 --- a/docs/src/dev-docs/index.md +++ b/docs/src/dev-docs/index.md @@ -1,6 +1,6 @@ # Developer docs -These docs are useful for developing CLP. Use the left sidebar (if it's hidden, click the +These docs are useful in developing CLP. Use the left sidebar (if it's hidden, click the icon) to navigate to specific docs. The sections are as follows: