You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by GitBox <gi...@apache.org> on 2020/03/13 18:58:44 UTC
[GitHub] [camel-website] aashnajena opened a new pull request #216:
[CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
aashnajena opened a new pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216
- Removing sub-menus under Documentation to avoid clutter.
- Grouping topics under documentation to improve readability
Please suggest new ways of organizing the content if necessary? I'm a little unsure about the Lists - should it be a table? Or perhaps something more creative? Please suggest!
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] aashnajena commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
aashnajena commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r398691560
##########
File path: content/documentations/_index.md
##########
@@ -0,0 +1,26 @@
+---
+title: Documentations for Apache Camel
+---
+
Review comment:
I hope the changes are better now!
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] aashnajena commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
aashnajena commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r398660817
##########
File path: config.toml
##########
@@ -56,76 +56,7 @@ timeout = 300000
name = "Documentation"
identifier = "docs"
weight = 4
-
-[[menu.main]]
- name = "Getting started"
- parent = "docs"
- weight = 1
- identifier = "getting-started"
- url = "/manual/latest/getting-started.html"
-
-[[menu.main]]
- name = "User manual"
- parent = "docs"
- weight = 2
- identifier = "manual"
- url = "/manual/latest/"
-
-[[menu.main]]
- name = "Component reference"
- parent = "docs"
- weight = 3
- identifier = "components"
- url = "/components/latest/"
-
-[[menu.main]]
- name = "API Documentation"
- parent = "docs"
- weight = 4
- identifier = "api-documentation"
- url = "https://www.javadoc.io/doc/org.apache.camel/camel-api/latest/index.html"
-
-[[menu.main]]
- name = "Camel K"
- parent = "docs"
- weight = 5
- identifier = "camel-k"
- url = "/camel-k/latest/"
-
-[[menu.main]]
- name = "Camel Quarkus"
- parent = "docs"
- weight = 6
- identifier = "camel-quarkus"
- url = "/camel-quarkus/latest/"
-
-[[menu.main]]
- name = "Camel Kafka Connector"
- parent = "docs"
- weight = 7
- identifier = "camel-kafka-connector"
- url = "/camel-kafka-connector/latest/"
-
-[[menu.main]]
- name = "Enterprise Integration Patterns"
- parent = "docs"
- weight = 8
- identifier = "eip"
- url = "/manual/latest/enterprise-integration-patterns.html"
-
-[[menu.main]]
- name = "Camel 2.x to 3.0 Migration Guide"
- parent = "docs"
- weight = 9
- identifier = "camel-3-migration-guide"
- url = "/manual/latest/camel-3-migration-guide.html"
-
-[[menu.main]]
- name = "Camel 3.x Upgrade Guide"
- parent = "docs"
- weight = 10
- identifier = "camel-3x-upgrade-guide"
- url = "/manual/latest/camel-3x-upgrade-guide.html"
+ url = "/documentations/"
Review comment:
On it!
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] aashnajena commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
aashnajena commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r396557893
##########
File path: content/documentations/_index.md
##########
@@ -0,0 +1,26 @@
+---
+title: Documentations for Apache Camel
Review comment:
I have added all the suggestions related to rephrasing of content.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r399220983
##########
File path: content/docs/_index.md
##########
@@ -0,0 +1,28 @@
+---
+title: Apache Camel Documentation
+---
+
+This page provides an overview of all kinds of documentations available for Apache Camel. Everything related to setting up, contributing, upgrading, migrating and understanding the Apache Camel architecture can be found under [User Manual](/docs/#user-manual). For documentations related to specific projects, look under the [Sub-Projects](/docs/#camel-sub-projects-documentation) section. To find component specific documentation, references are listed under [Components](/docs/#components). To contribute to the documentation, you can click on the "Edit this Page" link present at the bottom of each page.
+
+## User Manual
+
+The [User Manual](/manual/latest) is a comprehensive guide meant to help you with the key concepts of Apache Camel and software integration, from how to [begin contributing](/manual/latest/contributing.html) to Apache Camel, to [architecture](/manual/latest/architecture.html) or [integration patterns](/components/latest/eips/enterprise-integration-patterns.html).
Review comment:
```suggestion
The [User Manual](/manual/latest/) is a comprehensive guide meant to help you with the key concepts of Apache Camel and software integration, from how to [begin contributing](/manual/latest/contributing.html) to Apache Camel, to [architecture](/manual/latest/architecture.html) or [integration patterns](/components/latest/eips/enterprise-integration-patterns.html).
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r396454113
##########
File path: layouts/documentations/documentations.html
##########
@@ -0,0 +1,15 @@
+{{ partial "header.html" . }}
Review comment:
I thought we have a default layout that looks like this one that would be used instead, less duplication that way.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] aashnajena commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
aashnajena commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r397179032
##########
File path: config.toml
##########
@@ -56,76 +56,7 @@ timeout = 300000
name = "Documentation"
identifier = "docs"
weight = 4
-
-[[menu.main]]
- name = "Getting started"
- parent = "docs"
- weight = 1
- identifier = "getting-started"
- url = "/manual/latest/getting-started.html"
-
-[[menu.main]]
- name = "User manual"
- parent = "docs"
- weight = 2
- identifier = "manual"
- url = "/manual/latest/"
-
-[[menu.main]]
- name = "Component reference"
- parent = "docs"
- weight = 3
- identifier = "components"
- url = "/components/latest/"
-
-[[menu.main]]
- name = "API Documentation"
- parent = "docs"
- weight = 4
- identifier = "api-documentation"
- url = "https://www.javadoc.io/doc/org.apache.camel/camel-api/latest/index.html"
-
-[[menu.main]]
- name = "Camel K"
- parent = "docs"
- weight = 5
- identifier = "camel-k"
- url = "/camel-k/latest/"
-
-[[menu.main]]
- name = "Camel Quarkus"
- parent = "docs"
- weight = 6
- identifier = "camel-quarkus"
- url = "/camel-quarkus/latest/"
-
-[[menu.main]]
- name = "Camel Kafka Connector"
- parent = "docs"
- weight = 7
- identifier = "camel-kafka-connector"
- url = "/camel-kafka-connector/latest/"
-
-[[menu.main]]
- name = "Enterprise Integration Patterns"
- parent = "docs"
- weight = 8
- identifier = "eip"
- url = "/manual/latest/enterprise-integration-patterns.html"
-
-[[menu.main]]
- name = "Camel 2.x to 3.0 Migration Guide"
- parent = "docs"
- weight = 9
- identifier = "camel-3-migration-guide"
- url = "/manual/latest/camel-3-migration-guide.html"
-
-[[menu.main]]
- name = "Camel 3.x Upgrade Guide"
- parent = "docs"
- weight = 10
- identifier = "camel-3x-upgrade-guide"
- url = "/manual/latest/camel-3x-upgrade-guide.html"
+ url = "/documentations/"
Review comment:
Shouldn't I be making a documentation.md file for content and a separate html layout file?
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on issue #216: [CAMEL-14581]
Remove sub-menus for documentation and Reorganize Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on issue #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#issuecomment-603205013
We need to rebase this, also we need to consider that the changes in #195 will conflict with the changes here so we need to work on getting one or the other merged first.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] aashnajena commented on issue #216: [CAMEL-14581]
Remove sub-menus for documentation and Reorganize Documentation menu
Posted by GitBox <gi...@apache.org>.
aashnajena commented on issue #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#issuecomment-605012122
I did run yarn checks and fixed the integration patterns link, I think I forgot to commit this one. Is this ready to be merged now? Thanks!
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r398470424
##########
File path: config.toml
##########
@@ -56,76 +56,7 @@ timeout = 300000
name = "Documentation"
identifier = "docs"
weight = 4
-
-[[menu.main]]
- name = "Getting started"
- parent = "docs"
- weight = 1
- identifier = "getting-started"
- url = "/manual/latest/getting-started.html"
-
-[[menu.main]]
- name = "User manual"
- parent = "docs"
- weight = 2
- identifier = "manual"
- url = "/manual/latest/"
-
-[[menu.main]]
- name = "Component reference"
- parent = "docs"
- weight = 3
- identifier = "components"
- url = "/components/latest/"
-
-[[menu.main]]
- name = "API Documentation"
- parent = "docs"
- weight = 4
- identifier = "api-documentation"
- url = "https://www.javadoc.io/doc/org.apache.camel/camel-api/latest/index.html"
-
-[[menu.main]]
- name = "Camel K"
- parent = "docs"
- weight = 5
- identifier = "camel-k"
- url = "/camel-k/latest/"
-
-[[menu.main]]
- name = "Camel Quarkus"
- parent = "docs"
- weight = 6
- identifier = "camel-quarkus"
- url = "/camel-quarkus/latest/"
-
-[[menu.main]]
- name = "Camel Kafka Connector"
- parent = "docs"
- weight = 7
- identifier = "camel-kafka-connector"
- url = "/camel-kafka-connector/latest/"
-
-[[menu.main]]
- name = "Enterprise Integration Patterns"
- parent = "docs"
- weight = 8
- identifier = "eip"
- url = "/manual/latest/enterprise-integration-patterns.html"
-
-[[menu.main]]
- name = "Camel 2.x to 3.0 Migration Guide"
- parent = "docs"
- weight = 9
- identifier = "camel-3-migration-guide"
- url = "/manual/latest/camel-3-migration-guide.html"
-
-[[menu.main]]
- name = "Camel 3.x Upgrade Guide"
- parent = "docs"
- weight = 10
- identifier = "camel-3x-upgrade-guide"
- url = "/manual/latest/camel-3x-upgrade-guide.html"
+ url = "/documentations/"
Review comment:
I'd put this `_index.md` in `content/docs` and use the `layout/default/section.html` layout (which should be applied by default).
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] aashnajena commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
aashnajena commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r397179032
##########
File path: config.toml
##########
@@ -56,76 +56,7 @@ timeout = 300000
name = "Documentation"
identifier = "docs"
weight = 4
-
-[[menu.main]]
- name = "Getting started"
- parent = "docs"
- weight = 1
- identifier = "getting-started"
- url = "/manual/latest/getting-started.html"
-
-[[menu.main]]
- name = "User manual"
- parent = "docs"
- weight = 2
- identifier = "manual"
- url = "/manual/latest/"
-
-[[menu.main]]
- name = "Component reference"
- parent = "docs"
- weight = 3
- identifier = "components"
- url = "/components/latest/"
-
-[[menu.main]]
- name = "API Documentation"
- parent = "docs"
- weight = 4
- identifier = "api-documentation"
- url = "https://www.javadoc.io/doc/org.apache.camel/camel-api/latest/index.html"
-
-[[menu.main]]
- name = "Camel K"
- parent = "docs"
- weight = 5
- identifier = "camel-k"
- url = "/camel-k/latest/"
-
-[[menu.main]]
- name = "Camel Quarkus"
- parent = "docs"
- weight = 6
- identifier = "camel-quarkus"
- url = "/camel-quarkus/latest/"
-
-[[menu.main]]
- name = "Camel Kafka Connector"
- parent = "docs"
- weight = 7
- identifier = "camel-kafka-connector"
- url = "/camel-kafka-connector/latest/"
-
-[[menu.main]]
- name = "Enterprise Integration Patterns"
- parent = "docs"
- weight = 8
- identifier = "eip"
- url = "/manual/latest/enterprise-integration-patterns.html"
-
-[[menu.main]]
- name = "Camel 2.x to 3.0 Migration Guide"
- parent = "docs"
- weight = 9
- identifier = "camel-3-migration-guide"
- url = "/manual/latest/camel-3-migration-guide.html"
-
-[[menu.main]]
- name = "Camel 3.x Upgrade Guide"
- parent = "docs"
- weight = 10
- identifier = "camel-3x-upgrade-guide"
- url = "/manual/latest/camel-3x-upgrade-guide.html"
+ url = "/documentations/"
Review comment:
Shouldn't I be making a documentation.md file for content?
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r397106540
##########
File path: config.toml
##########
@@ -56,76 +56,7 @@ timeout = 300000
name = "Documentation"
identifier = "docs"
weight = 4
-
-[[menu.main]]
- name = "Getting started"
- parent = "docs"
- weight = 1
- identifier = "getting-started"
- url = "/manual/latest/getting-started.html"
-
-[[menu.main]]
- name = "User manual"
- parent = "docs"
- weight = 2
- identifier = "manual"
- url = "/manual/latest/"
-
-[[menu.main]]
- name = "Component reference"
- parent = "docs"
- weight = 3
- identifier = "components"
- url = "/components/latest/"
-
-[[menu.main]]
- name = "API Documentation"
- parent = "docs"
- weight = 4
- identifier = "api-documentation"
- url = "https://www.javadoc.io/doc/org.apache.camel/camel-api/latest/index.html"
-
-[[menu.main]]
- name = "Camel K"
- parent = "docs"
- weight = 5
- identifier = "camel-k"
- url = "/camel-k/latest/"
-
-[[menu.main]]
- name = "Camel Quarkus"
- parent = "docs"
- weight = 6
- identifier = "camel-quarkus"
- url = "/camel-quarkus/latest/"
-
-[[menu.main]]
- name = "Camel Kafka Connector"
- parent = "docs"
- weight = 7
- identifier = "camel-kafka-connector"
- url = "/camel-kafka-connector/latest/"
-
-[[menu.main]]
- name = "Enterprise Integration Patterns"
- parent = "docs"
- weight = 8
- identifier = "eip"
- url = "/manual/latest/enterprise-integration-patterns.html"
-
-[[menu.main]]
- name = "Camel 2.x to 3.0 Migration Guide"
- parent = "docs"
- weight = 9
- identifier = "camel-3-migration-guide"
- url = "/manual/latest/camel-3-migration-guide.html"
-
-[[menu.main]]
- name = "Camel 3.x Upgrade Guide"
- parent = "docs"
- weight = 10
- identifier = "camel-3x-upgrade-guide"
- url = "/manual/latest/camel-3x-upgrade-guide.html"
+ url = "/documentations/"
Review comment:
As we have it currently the `/documentations/` would not contain anything other than `index.html`, all the documentation we have is under `/manual/...`, `/components/...` and so on. I think it's better to have just `/documentation.html`.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r396453654
##########
File path: content/documentations/_index.md
##########
@@ -0,0 +1,26 @@
+---
+title: Documentations for Apache Camel
+---
+
+## User Manual
+
+The User Manual is a comprehensive guide meant to answer all your questions - from how to begin contributing to Apache Camel, to architecture and integration patterns.
+
+ - [How to Get Started](/manual/latest/getting-started.html)
+ - [Enterprise Integration Patterns](/manual/latest/enterprise-integration-patterns.html)
+ - [Camel 2.x to 3.0 Migration Guide](/manual/latest/camel-3-migration-guide.html)
+ - [Camel 3.x Upgrade Guide](/manual/latest/camel-3x-upgrade-guide.html)
+ - [FULL USER MANUAL](/manual/latest/)
+
+## Project Documentation
+
+Apache Camel encompasses several projects which offer many services to the user. Check out the manuals and documentation for these projects here :
+
+- [Camel-K](/camel-k/latest/)
+- [Camel Quarkus](/camel-quarkus/latest/)
+- [Camel Kafka Connector](/camel-kafka-connector/latest/)
+- [JavaDocs documentation](https://www.javadoc.io/doc/org.apache.camel/camel-api/latest/index.html) for Apache's APIs for Camel Core, Camel Catalog, Camel Cloud, Camel Cluster Support and Camel SPI etc.
+
+## Components
+
+[Component Reference Guide](/components/latest/) provides a detailed list of Camel components, their utilities and details about which versions support each component.
Review comment:
Perhaps:
```suggestion
[Component Reference](/components/latest/) is auto generated from the code to reflect the configuration options and functionality available in a particular Camel version.
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] aashnajena edited a comment on issue #216:
[CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
aashnajena edited a comment on issue #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#issuecomment-604499275
I think this is much cleaner now. Added `_index.md` in `/docs/` and used the `layouts/_default/section.html` template for rendering it. Thanks for the suggestions!
Rebased and added introduction.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r396449189
##########
File path: content/documentations/_index.md
##########
@@ -0,0 +1,26 @@
+---
+title: Documentations for Apache Camel
+---
+
+## User Manual
+
+The User Manual is a comprehensive guide meant to answer all your questions - from how to begin contributing to Apache Camel, to architecture and integration patterns.
+
+ - [How to Get Started](/manual/latest/getting-started.html)
+ - [Enterprise Integration Patterns](/manual/latest/enterprise-integration-patterns.html)
+ - [Camel 2.x to 3.0 Migration Guide](/manual/latest/camel-3-migration-guide.html)
+ - [Camel 3.x Upgrade Guide](/manual/latest/camel-3x-upgrade-guide.html)
+ - [FULL USER MANUAL](/manual/latest/)
+
+## Project Documentation
Review comment:
Perhaps:
```suggestion
## Camel sub-projects documentation
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] aashnajena commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
aashnajena commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r396557893
##########
File path: content/documentations/_index.md
##########
@@ -0,0 +1,26 @@
+---
+title: Documentations for Apache Camel
Review comment:
All the comments about rephrasing content are much better than what I had written originally, thank you. I have added all those suggestions.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] aashnajena commented on issue #216: [CAMEL-14581]
Remove sub-menus for documentation and Reorganize Documentation menu
Posted by GitBox <gi...@apache.org>.
aashnajena commented on issue #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#issuecomment-604499275
I think this is much cleaner now. Added `_index.md` in `/docs/` and used the `layouts/_default/section.html` template for rendering it. Thanks for the suggestions!
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on issue #216: [CAMEL-14581]
Remove sub-menus for documentation and Reorganize Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on issue #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#issuecomment-606243009
> Added your suggestion. Does Camel Karaf need to be added under the Projects page also?
It's there already
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r400194990
##########
File path: content/docs/_index.md
##########
@@ -0,0 +1,28 @@
+---
+title: Apache Camel Documentation
+---
+
+This page provides an overview of all kinds of documentations available for Apache Camel. Everything related to setting up, contributing, upgrading, migrating and understanding the Apache Camel architecture can be found under [User Manual](/docs/#user-manual). For documentations related to specific projects, look under the [Sub-Projects](/docs/#camel-sub-projects-documentation) section. To find component specific documentation, references are listed under [Components](/docs/#components). To contribute to the documentation, you can click on the "Edit this Page" link present at the bottom of each page.
+
+## User Manual
+
+The [User Manual](/manual/latest/) is a comprehensive guide meant to help you with the key concepts of Apache Camel and software integration, from how to [begin contributing](/manual/latest/contributing.html) to Apache Camel, to [architecture](/manual/latest/architecture.html) or [integration patterns](/components/latest/eips/enterprise-integration-patterns.html).
+
+ - [How to Get Started](/manual/latest/getting-started.html)
+ - [Enterprise Integration Patterns](/components/latest/eips/enterprise-integration-patterns.html)
+ - [Camel 2.x to 3.0 Migration Guide](/manual/latest/camel-3-migration-guide.html)
+ - [Camel 3.x Upgrade Guide](/manual/latest/camel-3x-upgrade-guide.html)
+ - [Complete User Manual](/manual/latest/)
+
+## Camel Sub-Projects Documentation
+
+Apache Camel encompasses several sub-projects for additional platforms or ways to run Camel. Check out the individual sub-project manuals here :
+
+- [Camel-K](/camel-k/latest/)
+- [Camel Quarkus](/camel-quarkus/latest/)
+- [Camel Kafka Connector](/camel-kafka-connector/latest/)
Review comment:
We recently added Camel Karaf as well
```suggestion
- [Camel Kafka Connector](/camel-kafka-connector/latest/)
- [Camel Karaf](/camel-karaf-connector/latest/)
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r396441809
##########
File path: config.toml
##########
@@ -56,76 +56,7 @@ timeout = 300000
name = "Documentation"
identifier = "docs"
weight = 4
-
-[[menu.main]]
- name = "Getting started"
- parent = "docs"
- weight = 1
- identifier = "getting-started"
- url = "/manual/latest/getting-started.html"
-
-[[menu.main]]
- name = "User manual"
- parent = "docs"
- weight = 2
- identifier = "manual"
- url = "/manual/latest/"
-
-[[menu.main]]
- name = "Component reference"
- parent = "docs"
- weight = 3
- identifier = "components"
- url = "/components/latest/"
-
-[[menu.main]]
- name = "API Documentation"
- parent = "docs"
- weight = 4
- identifier = "api-documentation"
- url = "https://www.javadoc.io/doc/org.apache.camel/camel-api/latest/index.html"
-
-[[menu.main]]
- name = "Camel K"
- parent = "docs"
- weight = 5
- identifier = "camel-k"
- url = "/camel-k/latest/"
-
-[[menu.main]]
- name = "Camel Quarkus"
- parent = "docs"
- weight = 6
- identifier = "camel-quarkus"
- url = "/camel-quarkus/latest/"
-
-[[menu.main]]
- name = "Camel Kafka Connector"
- parent = "docs"
- weight = 7
- identifier = "camel-kafka-connector"
- url = "/camel-kafka-connector/latest/"
-
-[[menu.main]]
- name = "Enterprise Integration Patterns"
- parent = "docs"
- weight = 8
- identifier = "eip"
- url = "/manual/latest/enterprise-integration-patterns.html"
-
-[[menu.main]]
- name = "Camel 2.x to 3.0 Migration Guide"
- parent = "docs"
- weight = 9
- identifier = "camel-3-migration-guide"
- url = "/manual/latest/camel-3-migration-guide.html"
-
-[[menu.main]]
- name = "Camel 3.x Upgrade Guide"
- parent = "docs"
- weight = 10
- identifier = "camel-3x-upgrade-guide"
- url = "/manual/latest/camel-3x-upgrade-guide.html"
+ url = "/documentations/"
Review comment:
I'd go with:
```suggestion
url = "/documentation.html"
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] aashnajena commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
aashnajena commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r396554881
##########
File path: config.toml
##########
@@ -56,76 +56,7 @@ timeout = 300000
name = "Documentation"
identifier = "docs"
weight = 4
-
-[[menu.main]]
- name = "Getting started"
- parent = "docs"
- weight = 1
- identifier = "getting-started"
- url = "/manual/latest/getting-started.html"
-
-[[menu.main]]
- name = "User manual"
- parent = "docs"
- weight = 2
- identifier = "manual"
- url = "/manual/latest/"
-
-[[menu.main]]
- name = "Component reference"
- parent = "docs"
- weight = 3
- identifier = "components"
- url = "/components/latest/"
-
-[[menu.main]]
- name = "API Documentation"
- parent = "docs"
- weight = 4
- identifier = "api-documentation"
- url = "https://www.javadoc.io/doc/org.apache.camel/camel-api/latest/index.html"
-
-[[menu.main]]
- name = "Camel K"
- parent = "docs"
- weight = 5
- identifier = "camel-k"
- url = "/camel-k/latest/"
-
-[[menu.main]]
- name = "Camel Quarkus"
- parent = "docs"
- weight = 6
- identifier = "camel-quarkus"
- url = "/camel-quarkus/latest/"
-
-[[menu.main]]
- name = "Camel Kafka Connector"
- parent = "docs"
- weight = 7
- identifier = "camel-kafka-connector"
- url = "/camel-kafka-connector/latest/"
-
-[[menu.main]]
- name = "Enterprise Integration Patterns"
- parent = "docs"
- weight = 8
- identifier = "eip"
- url = "/manual/latest/enterprise-integration-patterns.html"
-
-[[menu.main]]
- name = "Camel 2.x to 3.0 Migration Guide"
- parent = "docs"
- weight = 9
- identifier = "camel-3-migration-guide"
- url = "/manual/latest/camel-3-migration-guide.html"
-
-[[menu.main]]
- name = "Camel 3.x Upgrade Guide"
- parent = "docs"
- weight = 10
- identifier = "camel-3x-upgrade-guide"
- url = "/manual/latest/camel-3x-upgrade-guide.html"
+ url = "/documentations/"
Review comment:
I'm not sure what you mean, sir. Should we not have a /documentations/ folder, but just a documentation.html file?
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] aashnajena commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
aashnajena commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r396554881
##########
File path: config.toml
##########
@@ -56,76 +56,7 @@ timeout = 300000
name = "Documentation"
identifier = "docs"
weight = 4
-
-[[menu.main]]
- name = "Getting started"
- parent = "docs"
- weight = 1
- identifier = "getting-started"
- url = "/manual/latest/getting-started.html"
-
-[[menu.main]]
- name = "User manual"
- parent = "docs"
- weight = 2
- identifier = "manual"
- url = "/manual/latest/"
-
-[[menu.main]]
- name = "Component reference"
- parent = "docs"
- weight = 3
- identifier = "components"
- url = "/components/latest/"
-
-[[menu.main]]
- name = "API Documentation"
- parent = "docs"
- weight = 4
- identifier = "api-documentation"
- url = "https://www.javadoc.io/doc/org.apache.camel/camel-api/latest/index.html"
-
-[[menu.main]]
- name = "Camel K"
- parent = "docs"
- weight = 5
- identifier = "camel-k"
- url = "/camel-k/latest/"
-
-[[menu.main]]
- name = "Camel Quarkus"
- parent = "docs"
- weight = 6
- identifier = "camel-quarkus"
- url = "/camel-quarkus/latest/"
-
-[[menu.main]]
- name = "Camel Kafka Connector"
- parent = "docs"
- weight = 7
- identifier = "camel-kafka-connector"
- url = "/camel-kafka-connector/latest/"
-
-[[menu.main]]
- name = "Enterprise Integration Patterns"
- parent = "docs"
- weight = 8
- identifier = "eip"
- url = "/manual/latest/enterprise-integration-patterns.html"
-
-[[menu.main]]
- name = "Camel 2.x to 3.0 Migration Guide"
- parent = "docs"
- weight = 9
- identifier = "camel-3-migration-guide"
- url = "/manual/latest/camel-3-migration-guide.html"
-
-[[menu.main]]
- name = "Camel 3.x Upgrade Guide"
- parent = "docs"
- weight = 10
- identifier = "camel-3x-upgrade-guide"
- url = "/manual/latest/camel-3x-upgrade-guide.html"
+ url = "/documentations/"
Review comment:
So I should not make a /documetations folder? We should just have a file?
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r397107154
##########
File path: layouts/documentations/documentations.html
##########
@@ -0,0 +1,15 @@
+{{ partial "header.html" . }}
Review comment:
Then perhaps we do not have one :(
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] aashnajena commented on issue #216: [CAMEL-14581]
Remove sub-menus for documentation and Reorganize Documentation menu
Posted by GitBox <gi...@apache.org>.
aashnajena commented on issue #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#issuecomment-606127743
Added your suggestion. Does Camel Karaf need to be added under the Projects page also?
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] aashnajena commented on issue #216: [CAMEL-14581]
Remove sub-menus for documentation and Reorganize Documentation menu
Posted by GitBox <gi...@apache.org>.
aashnajena commented on issue #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#issuecomment-603244483
Hey, 195 should be merged first I think. As soon as that happens, I'll rebase this accordingly!
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r396442219
##########
File path: content/documentations/_index.md
##########
@@ -0,0 +1,26 @@
+---
+title: Documentations for Apache Camel
+---
+
+## User Manual
+
+The User Manual is a comprehensive guide meant to answer all your questions - from how to begin contributing to Apache Camel, to architecture and integration patterns.
+
+ - [How to Get Started](/manual/latest/getting-started.html)
+ - [Enterprise Integration Patterns](/manual/latest/enterprise-integration-patterns.html)
+ - [Camel 2.x to 3.0 Migration Guide](/manual/latest/camel-3-migration-guide.html)
+ - [Camel 3.x Upgrade Guide](/manual/latest/camel-3x-upgrade-guide.html)
+ - [FULL USER MANUAL](/manual/latest/)
Review comment:
I'd go with:
```suggestion
- [Complete User manual](/manual/latest/)
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] aashnajena commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
aashnajena commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r397162856
##########
File path: layouts/documentations/documentations.html
##########
@@ -0,0 +1,15 @@
+{{ partial "header.html" . }}
Review comment:
There does exist a _default in /layouts folder. But I don't know how to use that layout here. Can you please guide me on how to link a layout to a markdown file?
OR, should I just make a documentation.html file and write both content + layout (html) as suggested above?
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r396443531
##########
File path: content/documentations/_index.md
##########
@@ -0,0 +1,26 @@
+---
+title: Documentations for Apache Camel
+---
+
+## User Manual
+
+The User Manual is a comprehensive guide meant to answer all your questions - from how to begin contributing to Apache Camel, to architecture and integration patterns.
+
+ - [How to Get Started](/manual/latest/getting-started.html)
+ - [Enterprise Integration Patterns](/manual/latest/enterprise-integration-patterns.html)
+ - [Camel 2.x to 3.0 Migration Guide](/manual/latest/camel-3-migration-guide.html)
+ - [Camel 3.x Upgrade Guide](/manual/latest/camel-3x-upgrade-guide.html)
+ - [FULL USER MANUAL](/manual/latest/)
+
+## Project Documentation
+
+Apache Camel encompasses several projects which offer many services to the user. Check out the manuals and documentation for these projects here :
+
+- [Camel-K](/camel-k/latest/)
+- [Camel Quarkus](/camel-quarkus/latest/)
+- [Camel Kafka Connector](/camel-kafka-connector/latest/)
+- [JavaDocs documentation](https://www.javadoc.io/doc/org.apache.camel/camel-api/latest/index.html) for Apache's APIs for Camel Core, Camel Catalog, Camel Cloud, Camel Cluster Support and Camel SPI etc.
Review comment:
For text I'd go with something like:
```suggestion
- [API documentation](https://www.javadoc.io/doc/org.apache.camel/camel-api/latest/index.html)
```
Though this relates more to the Camel itself not to the sub-projects, so it needs be with in the user manual section. Perhaps that section needs to be renamed also as it won't be containing just the user manual.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] aashnajena commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
aashnajena commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r396545596
##########
File path: layouts/documentations/documentations.html
##########
@@ -0,0 +1,15 @@
+{{ partial "header.html" . }}
Review comment:
How do I use the default layout? If I don't make a documentations.html file, the content doesn't seem to follow the default layout by itself.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r396441310
##########
File path: content/documentations/_index.md
##########
@@ -0,0 +1,26 @@
+---
+title: Documentations for Apache Camel
Review comment:
I'd go with:
```suggestion
title: Apache Camel documentation
```
and place this file in `content/documentation`.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r396448761
##########
File path: content/documentations/_index.md
##########
@@ -0,0 +1,26 @@
+---
+title: Documentations for Apache Camel
+---
+
Review comment:
I think we need an introduction here on how to find the right documentation and how to contribute to the documentation.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r398470968
##########
File path: content/documentations/_index.md
##########
@@ -0,0 +1,26 @@
+---
+title: Documentations for Apache Camel
+---
+
+## User Manual
+
+The User Manual is a comprehensive guide meant to answer all your questions - from how to begin contributing to Apache Camel, to architecture and integration patterns.
+
+ - [How to Get Started](/manual/latest/getting-started.html)
+ - [Enterprise Integration Patterns](/manual/latest/enterprise-integration-patterns.html)
+ - [Camel 2.x to 3.0 Migration Guide](/manual/latest/camel-3-migration-guide.html)
+ - [Camel 3.x Upgrade Guide](/manual/latest/camel-3x-upgrade-guide.html)
+ - [FULL USER MANUAL](/manual/latest/)
+
+## Project Documentation
+
+Apache Camel encompasses several projects which offer many services to the user. Check out the manuals and documentation for these projects here :
+
+- [Camel-K](/camel-k/latest/)
+- [Camel Quarkus](/camel-quarkus/latest/)
+- [Camel Kafka Connector](/camel-kafka-connector/latest/)
+- [JavaDocs documentation](https://www.javadoc.io/doc/org.apache.camel/camel-api/latest/index.html) for Apache's APIs for Camel Core, Camel Catalog, Camel Cloud, Camel Cluster Support and Camel SPI etc.
Review comment:
The API documentation is for Camel not for the sub-projects, that's why I would not put the API documentation under sub-projects.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r398471793
##########
File path: layouts/documentations/documentations.html
##########
@@ -0,0 +1,15 @@
+{{ partial "header.html" . }}
Review comment:
Have a look at the [template lookup order](https://gohugo.io/templates/lookup-order/) in Hugo documentation. For `_index.md` files I think `layouts/_default/section.html` is used.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r396451142
##########
File path: content/documentations/_index.md
##########
@@ -0,0 +1,26 @@
+---
+title: Documentations for Apache Camel
+---
+
+## User Manual
+
+The User Manual is a comprehensive guide meant to answer all your questions - from how to begin contributing to Apache Camel, to architecture and integration patterns.
+
+ - [How to Get Started](/manual/latest/getting-started.html)
+ - [Enterprise Integration Patterns](/manual/latest/enterprise-integration-patterns.html)
+ - [Camel 2.x to 3.0 Migration Guide](/manual/latest/camel-3-migration-guide.html)
+ - [Camel 3.x Upgrade Guide](/manual/latest/camel-3x-upgrade-guide.html)
+ - [FULL USER MANUAL](/manual/latest/)
+
+## Project Documentation
+
+Apache Camel encompasses several projects which offer many services to the user. Check out the manuals and documentation for these projects here :
Review comment:
```suggestion
Apache Camel encompasses several sub-projects for additional platforms or ways to run Camel. Check out the individual sub-project manuals here:
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r396448390
##########
File path: content/documentations/_index.md
##########
@@ -0,0 +1,26 @@
+---
+title: Documentations for Apache Camel
+---
+
+## User Manual
+
+The User Manual is a comprehensive guide meant to answer all your questions - from how to begin contributing to Apache Camel, to architecture and integration patterns.
Review comment:
Perhaps something like.
```suggestion
The [User Manual](/manual/latest) is a comprehensive guide meant to help you with the key concepts of Apache Camel and software integration, from how to [begin contributing](/manual/latest/contributing.html) to Apache Camel, to [architecture](/manual/latest/architecture.html) or [integration patterns](/components/latest/eips/enterprise-integration-patterns.html).
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] aashnajena commented on a change in pull request
#216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize
Documentation menu
Posted by GitBox <gi...@apache.org>.
aashnajena commented on a change in pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216#discussion_r397160352
##########
File path: content/documentations/_index.md
##########
@@ -0,0 +1,26 @@
+---
+title: Documentations for Apache Camel
+---
+
+## User Manual
+
+The User Manual is a comprehensive guide meant to answer all your questions - from how to begin contributing to Apache Camel, to architecture and integration patterns.
+
+ - [How to Get Started](/manual/latest/getting-started.html)
+ - [Enterprise Integration Patterns](/manual/latest/enterprise-integration-patterns.html)
+ - [Camel 2.x to 3.0 Migration Guide](/manual/latest/camel-3-migration-guide.html)
+ - [Camel 3.x Upgrade Guide](/manual/latest/camel-3x-upgrade-guide.html)
+ - [FULL USER MANUAL](/manual/latest/)
+
+## Project Documentation
+
+Apache Camel encompasses several projects which offer many services to the user. Check out the manuals and documentation for these projects here :
+
+- [Camel-K](/camel-k/latest/)
+- [Camel Quarkus](/camel-quarkus/latest/)
+- [Camel Kafka Connector](/camel-kafka-connector/latest/)
+- [JavaDocs documentation](https://www.javadoc.io/doc/org.apache.camel/camel-api/latest/index.html) for Apache's APIs for Camel Core, Camel Catalog, Camel Cloud, Camel Cluster Support and Camel SPI etc.
Review comment:
For this, should I move the API documentation to User Manual (and rename it to something else)? Or let it stay under sub-projects for now?
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services
[GitHub] [camel-website] zregvart merged pull request #216: [CAMEL-14581]
Remove sub-menus for documentation and Reorganize Documentation menu
Posted by GitBox <gi...@apache.org>.
zregvart merged pull request #216: [CAMEL-14581] Remove sub-menus for documentation and Reorganize Documentation menu
URL: https://github.com/apache/camel-website/pull/216
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
With regards,
Apache Git Services