You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@camel.apache.org by "Andrea Cosentino (Jira)" <ji...@apache.org> on 2020/05/01 07:08:00 UTC

[jira] [Comment Edited] (CAMEL-14995) [CAMEL-K] Not all traits pages are being generated

    [ https://issues.apache.org/jira/browse/CAMEL-14995?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17097206#comment-17097206 ] 

Andrea Cosentino edited comment on CAMEL-14995 at 5/1/20, 7:07 AM:
-------------------------------------------------------------------

We are losing some documentation, the PR must be reviewed with [~nferraro]


was (Author: ancosen):
The original PR must be reverted, because we are losing some documentation or at least it must be reviewed with [~nferraro]

> [CAMEL-K] Not all traits pages are being generated
> --------------------------------------------------
>
>                 Key: CAMEL-14995
>                 URL: https://issues.apache.org/jira/browse/CAMEL-14995
>             Project: Camel
>          Issue Type: Task
>          Components: camel-k, website
>    Affects Versions: 3.2.0
>            Reporter: David Jencks
>            Priority: Major
>
> While working on https://issues.apache.org/jira/browse/CAMEL-14993 I noticed that these pages are not actually generated:
>  delete mode 100755 docs/modules/ROOT/pages/traits/3scale.adoc
>  delete mode 100755 docs/modules/ROOT/pages/traits/debug.adoc
>  delete mode 100755 docs/modules/ROOT/pages/traits/master.adoc
> I also see:
> MacBook-Pro-2:camel-k david$ ./script/gen_doc.sh
> Generating traits documentation...
> W0430 09:59:35.227985   60469 parse.go:246] Ignoring child directory addons/master: unable to import "addons/master": package addons/master is not in GOROOT (/usr/local/Cellar/go/1.14.2_1/libexec/src/addons/master)
> W0430 09:59:35.329228   60469 parse.go:246] Ignoring child directory addons/threescale: unable to import "addons/threescale": package addons/threescale is not in GOROOT (/usr/local/Cellar/go/1.14.2_1/libexec/src/addons/threescale)
> I didn't see any instructions on how to generate the documentation, so I tried things until something happened.
> I think there are two problems:
> - some pages aren't getting generated
> - this isn't blindingly obvious.
> I suggest that to partly fix the second problem, the go doc generation for traits start by removing all the traits pages except the index page, traits.adoc.  At least git status will then indicate a change.  I don't know how to do this in go.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)