Skip to content

Conversation

MarkDaoust
Copy link
Member

@see lines try to link the whole line to the name, it tries to lookup these URLs as names in the API and fails:

@see name description

https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/DeviceSpec

Copy link
Collaborator

@Craigacp Craigacp left a comment

Choose a reason for hiding this comment

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

LGTM

@karllessard
Copy link
Collaborator

Thanks @MarkDaoust! Before merging, is your intention is to generate the documentation for 0.4.1 that we released last week? If so, the doc must be generated from ther0.4 branch, just want to check if we need to merge this PR in that branch instead.

@MarkDaoust
Copy link
Member Author

I was just planning on "eventual consistency", let's not make this more complicated than it needs to be.

@karllessard
Copy link
Collaborator

Well, looks like it will be more complicated than we were hoping for anyway, because Google's Java style checker did not liked it 😄 (see failing status in GitHub)

what about keeping @see and just passing the straight URL, with no markup nor label?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants