[
https://issues.apache.org/jira/browse/KNOX-1209?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16475880#comment-16475880
]
Larry McCay commented on KNOX-1209:
-----------------------------------
Sorry for the delay, [~lars_francke].
I am looking at it again and as last time, I feel like we need to tease out
what appear to be things that should be articulated as documentation style
conventions. Such as the single quotes around names of properties, files and
other such values. I do also still see some double quotes that are not only in
code snippets as literals. Not sure if this is intentional since a good number
of double quotes were replaced by single quotes.
I've been a little hesitant to commit without this style description but I
guess the docs themselves can hopefully be its own style guide. :)
It's just the sort of thing that will have folks adding the old stuff back in
as they go.
I'll get the patch applied and review the resulting docs and hopefully get it
in today.
Thank you for your patience, [~lars_francke]!
> Improvements to the 1.1.0 User Guide
> ------------------------------------
>
> Key: KNOX-1209
> URL: https://issues.apache.org/jira/browse/KNOX-1209
> Project: Apache Knox
> Issue Type: Improvement
> Components: Site
> Reporter: Lars Francke
> Assignee: Lars Francke
> Priority: Minor
> Fix For: 1.1.0
>
> Attachments: KNOX-1209.1.patch, KNOX-1209.2.patch
>
>
> I did this two years ago in KNOX-646 and I've done it again. I did read
> through the whole User Guide and fixed obvious mistakes, inconsistencies and
> formatting things.
> I'm sorry for the "code dump" I hope it's still useful. The patch is pretty
> large but the changes itself are pretty small.
> As last time I won't have much time to work on this patch.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
