OFBiz › OFBiz - Dev

[jira] Created: (OFBIZ-2133) Linking End User Documentation to OFBiz

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

28 messages Options

Nicolas Malin (Jira)

[jira] Created: (OFBIZ-2133) Linking End User Documentation to OFBiz

Linking End User Documentation to OFBiz
---------------------------------------

Key: OFBIZ-2133
URL: https://issues.apache.org/jira/browse/OFBIZ-2133
Project: OFBiz
Issue Type: New Feature
Reporter: Bruno Busco

I have seen that several updates are in progress in this http://docs.ofbiz.org/display/OFBIZ/End+User+Documentation
area of Confluence.
Specially the Accounting application seems going to be described with a one-to-one help page to OFBiz screens.

This is great and I think that having those pages linked to the relative OFBiz screens will be usefull and will also encourage more people to create (and _fill_) more documentation pages.

What is attached to this issue is a simple patch that creates this link using the "titleProperty" field.
It makes no use of the help request that is defined in the framework but uses an even simpler mechanism.

I would like to discuss this pattern, it is a first trial and I am not sure it will be OK for every case.

What I was also considering is to have the AccountingHelpUiLabels.xml file not committed but attached to the Confluence documentation main page.
In this way who updates the documentation can update this "index" file also.

Who is interested in using the onlline documentation will download this file and install infor OFBiz.

Who is interested to have a local copy of the help can consider using the export space function present in Confluence.
This creates a complete static HTML copy of the documentation. A specific version of the AccountingHelpUiLabels.xml can be used to access to this exported copy.

What do you think?

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Updated: (OFBIZ-2133) Linking End User Documentation to OFBiz

> Linking End User Documentation to OFBiz
> ---------------------------------------
>
> Key: OFBIZ-2133
> URL: https://issues.apache.org/jira/browse/OFBIZ-2133
> Project: OFBiz
> Issue Type: New Feature
> Reporter: Bruno Busco
> Attachments: AccountingHelpLinks.patch
>
>
> I have seen that several updates are in progress in this http://docs.ofbiz.org/display/OFBIZ/End+User+Documentation
> area of Confluence.
> Specially the Accounting application seems going to be described with a one-to-one help page to OFBiz screens.
> This is great and I think that having those pages linked to the relative OFBiz screens will be usefull and will also encourage more people to create (and _fill_) more documentation pages.
> What is attached to this issue is a simple patch that creates this link using the "titleProperty" field.
> It makes no use of the help request that is defined in the framework but uses an even simpler mechanism.
> I would like to discuss this pattern, it is a first trial and I am not sure it will be OK for every case.
> What I was also considering is to have the AccountingHelpUiLabels.xml file not committed but attached to the Confluence documentation main page.
> In this way who updates the documentation can update this "index" file also.
> Who is interested in using the onlline documentation will download this file and install infor OFBiz.
> Who is interested to have a local copy of the help can consider using the export space function present in Confluence.
> This creates a complete static HTML copy of the documentation. A specific version of the AccountingHelpUiLabels.xml can be used to access to this exported copy.
> What do you think?

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Commented: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

[ https://issues.apache.org/jira/browse/OFBIZ-2133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12671485#action_12671485 ]

Jacques Le Roux commented on OFBIZ-2133:
----------------------------------------

Hi Bruno,

I like the idea because it would allow for localised help. I think we should commit AccountingHelpUiLabels.xml *and* have it in Confluence also. Doing so we will hedge one's bets (I took this locution from the Net ;))

* We will then see if having it Confluence allows for more documentation/help efforts
* We will have it ready OOTB

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Commented: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

[ https://issues.apache.org/jira/browse/OFBIZ-2133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12671514#action_12671514 ]

Bruno Busco commented on OFBIZ-2133:
------------------------------------

Hi Jacques,
I have spent some time to find a way to integrate in the best way the help pages that are being developed on Confluence into OFBiz.
And this is what I did find.

The best would be to be IMO to periodically export the END-USER space in HTML, put all this content in an help component, zip everything and put back on a Confluence page.
Users could download this zip file and install it in the hot-deploy.
This should be all a user should do to install an updated help.

The solution in the patch, at the moment, is not so versatile but I do not know how to do what I have described.
It would be great to have help in doing it.

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Commented: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

[ https://issues.apache.org/jira/browse/OFBIZ-2133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12671520#action_12671520 ]

Jacques Le Roux commented on OFBIZ-2133:
----------------------------------------

Yes, this could be discussed and seems a good start to think about.
I only expressed the fact that one of the main goal of OFBiz applications is to be showcases of OFBiz power. So it could be interesting to have something ready to use to better attract new users (OOTB). And documentation is a very important part of convincing users of the power of a software...

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Commented: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

[ https://issues.apache.org/jira/browse/OFBIZ-2133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12671528#action_12671528 ]

Bruno Busco commented on OFBIZ-2133:
------------------------------------

I perfectly agree.
And having the Confluence documentation pages linked to OFBiz would give more "light" to the effort spent there.

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Assigned: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

[ https://issues.apache.org/jira/browse/OFBIZ-2133?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Bruno Busco reassigned OFBIZ-2133:
----------------------------------

Assignee: Bruno Busco

> Linking End User Documentation to OFBiz
> ---------------------------------------
>
> Key: OFBIZ-2133
> URL: https://issues.apache.org/jira/browse/OFBIZ-2133
> Project: OFBiz
> Issue Type: New Feature
> Reporter: Bruno Busco
> Assignee: Bruno Busco
> Attachments: AccountingHelpLinks.patch
>
>
> I have seen that several updates are in progress in this http://docs.ofbiz.org/display/OFBIZ/End+User+Documentation
> area of Confluence.
> Specially the Accounting application seems going to be described with a one-to-one help page to OFBiz screens.
> This is great and I think that having those pages linked to the relative OFBiz screens will be usefull and will also encourage more people to create (and _fill_) more documentation pages.
> What is attached to this issue is a simple patch that creates this link using the "titleProperty" field.
> It makes no use of the help request that is defined in the framework but uses an even simpler mechanism.
> I would like to discuss this pattern, it is a first trial and I am not sure it will be OK for every case.
> What I was also considering is to have the AccountingHelpUiLabels.xml file not committed but attached to the Confluence documentation main page.
> In this way who updates the documentation can update this "index" file also.
> Who is interested in using the onlline documentation will download this file and install infor OFBiz.
> Who is interested to have a local copy of the help can consider using the export space function present in Confluence.
> This creates a complete static HTML copy of the documentation. A specific version of the AccountingHelpUiLabels.xml can be used to access to this exported copy.
> What do you think?

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Updated: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

[ https://issues.apache.org/jira/browse/OFBIZ-2133?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Bruno Busco updated OFBIZ-2133:
-------------------------------

Fix Version/s: Release Branch 9.3

I am working to have a simple hot-deplyable application containing an html export from the End User Documentation Confluence area.
This will be ready hopefully soon.

BTW we should think to better organize the Open End User Documentation in order to have the export easier.
I would suggest to have a public writable Confluence space enterely dedicated to the End User Doc that we want to export and have available locally with links from OFBiz screens.
This would make the periodic export painless.
All pages in this space should follow the structure of OFBiz application screens (like the recently added pages).

> Linking End User Documentation to OFBiz
> ---------------------------------------
>
> Key: OFBIZ-2133
> URL: https://issues.apache.org/jira/browse/OFBIZ-2133
> Project: OFBiz
> Issue Type: New Feature
> Reporter: Bruno Busco
> Assignee: Bruno Busco
> Fix For: Release Branch 9.3
>
> Attachments: AccountingHelpLinks.patch
>
>
> I have seen that several updates are in progress in this http://docs.ofbiz.org/display/OFBIZ/End+User+Documentation
> area of Confluence.
> Specially the Accounting application seems going to be described with a one-to-one help page to OFBiz screens.
> This is great and I think that having those pages linked to the relative OFBiz screens will be usefull and will also encourage more people to create (and _fill_) more documentation pages.
> What is attached to this issue is a simple patch that creates this link using the "titleProperty" field.
> It makes no use of the help request that is defined in the framework but uses an even simpler mechanism.
> I would like to discuss this pattern, it is a first trial and I am not sure it will be OK for every case.
> What I was also considering is to have the AccountingHelpUiLabels.xml file not committed but attached to the Confluence documentation main page.
> In this way who updates the documentation can update this "index" file also.
> Who is interested in using the onlline documentation will download this file and install infor OFBiz.
> Who is interested to have a local copy of the help can consider using the export space function present in Confluence.
> This creates a complete static HTML copy of the documentation. A specific version of the AccountingHelpUiLabels.xml can be used to access to this exported copy.
> What do you think?

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Updated: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

> Linking End User Documentation to OFBiz
> ---------------------------------------
>
> Key: OFBIZ-2133
> URL: https://issues.apache.org/jira/browse/OFBIZ-2133
> Project: OFBiz
> Issue Type: New Feature
> Reporter: Bruno Busco
> Assignee: Bruno Busco
> Fix For: Release Branch 9.3
>
>
> I have seen that several updates are in progress in this http://docs.ofbiz.org/display/OFBIZ/End+User+Documentation
> area of Confluence.
> Specially the Accounting application seems going to be described with a one-to-one help page to OFBiz screens.
> This is great and I think that having those pages linked to the relative OFBiz screens will be usefull and will also encourage more people to create (and _fill_) more documentation pages.
> What is attached to this issue is a simple patch that creates this link using the "titleProperty" field.
> It makes no use of the help request that is defined in the framework but uses an even simpler mechanism.
> I would like to discuss this pattern, it is a first trial and I am not sure it will be OK for every case.
> What I was also considering is to have the AccountingHelpUiLabels.xml file not committed but attached to the Confluence documentation main page.
> In this way who updates the documentation can update this "index" file also.
> Who is interested in using the onlline documentation will download this file and install infor OFBiz.
> Who is interested to have a local copy of the help can consider using the export space function present in Confluence.
> This creates a complete static HTML copy of the documentation. A specific version of the AccountingHelpUiLabels.xml can be used to access to this exported copy.
> What do you think?

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Updated: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

[ https://issues.apache.org/jira/browse/OFBIZ-2133?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Bruno Busco updated OFBIZ-2133:
-------------------------------

Attachment: help.zip
help.patch

Please find attached my solution to link to OFBiz screens a locally available Confluence end user doc HTML export.
This is a first trial to share the idea.
If we are ok with this we should have a cleaner Confluence space dedicated to end-user online documentation.

The help.zip file could be periodically re-created and attached to a special Confluence page to be downloaded and installed in the hot-deploy.

Another option is to have the help application committed to SVN with the HTML files and periodically update them with a fresh export from Confluence.

WDYT?

> Linking End User Documentation to OFBiz
> ---------------------------------------
>
> Key: OFBIZ-2133
> URL: https://issues.apache.org/jira/browse/OFBIZ-2133
> Project: OFBiz
> Issue Type: New Feature
> Reporter: Bruno Busco
> Assignee: Bruno Busco
> Fix For: Release Branch 9.3
>
> Attachments: help.patch, help.zip
>
>
> I have seen that several updates are in progress in this http://docs.ofbiz.org/display/OFBIZ/End+User+Documentation
> area of Confluence.
> Specially the Accounting application seems going to be described with a one-to-one help page to OFBiz screens.
> This is great and I think that having those pages linked to the relative OFBiz screens will be usefull and will also encourage more people to create (and _fill_) more documentation pages.
> What is attached to this issue is a simple patch that creates this link using the "titleProperty" field.
> It makes no use of the help request that is defined in the framework but uses an even simpler mechanism.
> I would like to discuss this pattern, it is a first trial and I am not sure it will be OK for every case.
> What I was also considering is to have the AccountingHelpUiLabels.xml file not committed but attached to the Confluence documentation main page.
> In this way who updates the documentation can update this "index" file also.
> Who is interested in using the onlline documentation will download this file and install infor OFBiz.
> Who is interested to have a local copy of the help can consider using the export space function present in Confluence.
> This creates a complete static HTML copy of the documentation. A specific version of the AccountingHelpUiLabels.xml can be used to access to this exported copy.
> What do you think?

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Commented: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

[ https://issues.apache.org/jira/browse/OFBIZ-2133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12673033#action_12673033 ]

David E. Jones commented on OFBIZ-2133:
---------------------------------------

Rather than looking for the titleProperty, which can change and may not be unique, why not use a combination of the webapp name and the view name? It would not be as "pretty", but it would be more unique and easier to maintain over time.

The current view name is easy to get with the "_CURRENT_VIEW_" request attribute.

> Linking End User Documentation to OFBiz
> ---------------------------------------
>
> Key: OFBIZ-2133
> URL: https://issues.apache.org/jira/browse/OFBIZ-2133
> Project: OFBiz
> Issue Type: New Feature
> Reporter: Bruno Busco
> Assignee: Bruno Busco
> Fix For: Release Branch 9.3
>
> Attachments: help.patch, help.zip
>
>
> I have seen that several updates are in progress in this http://docs.ofbiz.org/display/OFBIZ/End+User+Documentation
> area of Confluence.
> Specially the Accounting application seems going to be described with a one-to-one help page to OFBiz screens.
> This is great and I think that having those pages linked to the relative OFBiz screens will be usefull and will also encourage more people to create (and _fill_) more documentation pages.
> What is attached to this issue is a simple patch that creates this link using the "titleProperty" field.
> It makes no use of the help request that is defined in the framework but uses an even simpler mechanism.
> I would like to discuss this pattern, it is a first trial and I am not sure it will be OK for every case.
> What I was also considering is to have the AccountingHelpUiLabels.xml file not committed but attached to the Confluence documentation main page.
> In this way who updates the documentation can update this "index" file also.
> Who is interested in using the onlline documentation will download this file and install infor OFBiz.
> Who is interested to have a local copy of the help can consider using the export space function present in Confluence.
> This creates a complete static HTML copy of the documentation. A specific version of the AccountingHelpUiLabels.xml can be used to access to this exported copy.
> What do you think?

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Commented: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

[ https://issues.apache.org/jira/browse/OFBIZ-2133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12673034#action_12673034 ]

David E. Jones commented on OFBIZ-2133:
---------------------------------------

Also, instead of having a hard-coded location (ie: "/help/control/main?topic=") we would have a lot of nice flexibility if we just put that in a properties file and treat it as a prefix.

OOTB I think we should just point to the wiki site and not require an export/etc in order to see the help. If people want their own help that is different from that in the wiki (decorated or changed content or whatever) they can just change the help URL prefix in the properties file and off they go...

The simpler we keep this the more chance of success it will have. We can make it more complicated later should needs arise once we've played with it more.

> Linking End User Documentation to OFBiz
> ---------------------------------------
>
> Key: OFBIZ-2133
> URL: https://issues.apache.org/jira/browse/OFBIZ-2133
> Project: OFBiz
> Issue Type: New Feature
> Reporter: Bruno Busco
> Assignee: Bruno Busco
> Fix For: Release Branch 9.3
>
> Attachments: help.patch, help.zip
>
>
> I have seen that several updates are in progress in this http://docs.ofbiz.org/display/OFBIZ/End+User+Documentation
> area of Confluence.
> Specially the Accounting application seems going to be described with a one-to-one help page to OFBiz screens.
> This is great and I think that having those pages linked to the relative OFBiz screens will be usefull and will also encourage more people to create (and _fill_) more documentation pages.
> What is attached to this issue is a simple patch that creates this link using the "titleProperty" field.
> It makes no use of the help request that is defined in the framework but uses an even simpler mechanism.
> I would like to discuss this pattern, it is a first trial and I am not sure it will be OK for every case.
> What I was also considering is to have the AccountingHelpUiLabels.xml file not committed but attached to the Confluence documentation main page.
> In this way who updates the documentation can update this "index" file also.
> Who is interested in using the onlline documentation will download this file and install infor OFBiz.
> Who is interested to have a local copy of the help can consider using the export space function present in Confluence.
> This creates a complete static HTML copy of the documentation. A specific version of the AccountingHelpUiLabels.xml can be used to access to this exported copy.
> What do you think?

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Commented: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

[ https://issues.apache.org/jira/browse/OFBIZ-2133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12673043#action_12673043 ]

Adrian Crum commented on OFBIZ-2133:
------------------------------------

I like David's idea of just pointing to the documentation. I had suggested something like that previously - https://issues.apache.org/jira/browse/OFBIZ-1873?focusedCommentId=12621261#action_12621261.

Not all of our OFBiz users have internet access, so it would be helpful to have OFBiz "pull down" the wiki content in a dynamic way.

> Linking End User Documentation to OFBiz
> ---------------------------------------
>
> Key: OFBIZ-2133
> URL: https://issues.apache.org/jira/browse/OFBIZ-2133
> Project: OFBiz
> Issue Type: New Feature
> Reporter: Bruno Busco
> Assignee: Bruno Busco
> Fix For: Release Branch 9.3
>
> Attachments: help.patch, help.zip
>
>
> I have seen that several updates are in progress in this http://docs.ofbiz.org/display/OFBIZ/End+User+Documentation
> area of Confluence.
> Specially the Accounting application seems going to be described with a one-to-one help page to OFBiz screens.
> This is great and I think that having those pages linked to the relative OFBiz screens will be usefull and will also encourage more people to create (and _fill_) more documentation pages.
> What is attached to this issue is a simple patch that creates this link using the "titleProperty" field.
> It makes no use of the help request that is defined in the framework but uses an even simpler mechanism.
> I would like to discuss this pattern, it is a first trial and I am not sure it will be OK for every case.
> What I was also considering is to have the AccountingHelpUiLabels.xml file not committed but attached to the Confluence documentation main page.
> In this way who updates the documentation can update this "index" file also.
> Who is interested in using the onlline documentation will download this file and install infor OFBiz.
> Who is interested to have a local copy of the help can consider using the export space function present in Confluence.
> This creates a complete static HTML copy of the documentation. A specific version of the AccountingHelpUiLabels.xml can be used to access to this exported copy.
> What do you think?

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Commented: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

[ https://issues.apache.org/jira/browse/OFBIZ-2133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12673047#action_12673047 ]

Jacques Le Roux commented on OFBIZ-2133:
----------------------------------------

+1 for webapp name + view name
+1 prefix in properties

Adrian should be consider to put the dynamic "pull dow" in svn repo (to have the dynamyc way working), in hot-deploy like Bruno suggested ?

> Linking End User Documentation to OFBiz
> ---------------------------------------
>
> Key: OFBIZ-2133
> URL: https://issues.apache.org/jira/browse/OFBIZ-2133
> Project: OFBiz
> Issue Type: New Feature
> Reporter: Bruno Busco
> Assignee: Bruno Busco
> Fix For: Release Branch 9.3
>
> Attachments: help.patch, help.zip
>
>
> I have seen that several updates are in progress in this http://docs.ofbiz.org/display/OFBIZ/End+User+Documentation
> area of Confluence.
> Specially the Accounting application seems going to be described with a one-to-one help page to OFBiz screens.
> This is great and I think that having those pages linked to the relative OFBiz screens will be usefull and will also encourage more people to create (and _fill_) more documentation pages.
> What is attached to this issue is a simple patch that creates this link using the "titleProperty" field.
> It makes no use of the help request that is defined in the framework but uses an even simpler mechanism.
> I would like to discuss this pattern, it is a first trial and I am not sure it will be OK for every case.
> What I was also considering is to have the AccountingHelpUiLabels.xml file not committed but attached to the Confluence documentation main page.
> In this way who updates the documentation can update this "index" file also.
> Who is interested in using the onlline documentation will download this file and install infor OFBiz.
> Who is interested to have a local copy of the help can consider using the export space function present in Confluence.
> This creates a complete static HTML copy of the documentation. A specific version of the AccountingHelpUiLabels.xml can be used to access to this exported copy.
> What do you think?

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Commented: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

[ https://issues.apache.org/jira/browse/OFBIZ-2133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12673052#action_12673052 ]

Bruno Busco commented on OFBIZ-2133:
------------------------------------

David,
thank you for the suggestion to use the webapp name and the view name. I will try this.

Regarding using a configuration parameter as prefix, this was my first idea. But then, when I exported a Confluence space and installed locally into hot-deploy I found that while locally I had to link the files with the .html extension, the url to have a page from a live Confluence are without .html and with a "+" instead of spaces. So it seems not to be possible with asimple prefix but we should have a completely different mapping file.

Adrian,
your suggestion in OFBIZ-1873 is interesting, I used an iframe in the ftl to render an external .html page in a screen but I was not really happy with this solution.
When you say ""pull down" the wiki content in a dynamic way" what you mean? Shouldn't the user have an internet access to do this?

> Linking End User Documentation to OFBiz
> ---------------------------------------
>
> Key: OFBIZ-2133
> URL: https://issues.apache.org/jira/browse/OFBIZ-2133
> Project: OFBiz
> Issue Type: New Feature
> Reporter: Bruno Busco
> Assignee: Bruno Busco
> Fix For: Release Branch 9.3
>
> Attachments: help.patch, help.zip
>
>
> I have seen that several updates are in progress in this http://docs.ofbiz.org/display/OFBIZ/End+User+Documentation
> area of Confluence.
> Specially the Accounting application seems going to be described with a one-to-one help page to OFBiz screens.
> This is great and I think that having those pages linked to the relative OFBiz screens will be usefull and will also encourage more people to create (and _fill_) more documentation pages.
> What is attached to this issue is a simple patch that creates this link using the "titleProperty" field.
> It makes no use of the help request that is defined in the framework but uses an even simpler mechanism.
> I would like to discuss this pattern, it is a first trial and I am not sure it will be OK for every case.
> What I was also considering is to have the AccountingHelpUiLabels.xml file not committed but attached to the Confluence documentation main page.
> In this way who updates the documentation can update this "index" file also.
> Who is interested in using the onlline documentation will download this file and install infor OFBiz.
> Who is interested to have a local copy of the help can consider using the export space function present in Confluence.
> This creates a complete static HTML copy of the documentation. A specific version of the AccountingHelpUiLabels.xml can be used to access to this exported copy.
> What do you think?

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Commented: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

[ https://issues.apache.org/jira/browse/OFBIZ-2133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12673056#action_12673056 ]

Adrian Crum commented on OFBIZ-2133:
------------------------------------

Jacques,

If you look at OFBIZ-1873 you will see that I was proposing a web scraper for the Help feature. So, when a user clicks on the Help link, an internal OFBiz server grabs the associated wiki content (from the wiki site) and stuffs it in the screen.

> Linking End User Documentation to OFBiz
> ---------------------------------------
>
> Key: OFBIZ-2133
> URL: https://issues.apache.org/jira/browse/OFBIZ-2133
> Project: OFBiz
> Issue Type: New Feature
> Reporter: Bruno Busco
> Assignee: Bruno Busco
> Fix For: Release Branch 9.3
>
> Attachments: help.patch, help.zip
>
>
> I have seen that several updates are in progress in this http://docs.ofbiz.org/display/OFBIZ/End+User+Documentation
> area of Confluence.
> Specially the Accounting application seems going to be described with a one-to-one help page to OFBiz screens.
> This is great and I think that having those pages linked to the relative OFBiz screens will be usefull and will also encourage more people to create (and _fill_) more documentation pages.
> What is attached to this issue is a simple patch that creates this link using the "titleProperty" field.
> It makes no use of the help request that is defined in the framework but uses an even simpler mechanism.
> I would like to discuss this pattern, it is a first trial and I am not sure it will be OK for every case.
> What I was also considering is to have the AccountingHelpUiLabels.xml file not committed but attached to the Confluence documentation main page.
> In this way who updates the documentation can update this "index" file also.
> Who is interested in using the onlline documentation will download this file and install infor OFBiz.
> Who is interested to have a local copy of the help can consider using the export space function present in Confluence.
> This creates a complete static HTML copy of the documentation. A specific version of the AccountingHelpUiLabels.xml can be used to access to this exported copy.
> What do you think?

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Commented: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

[ https://issues.apache.org/jira/browse/OFBIZ-2133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12673058#action_12673058 ]

David E. Jones commented on OFBIZ-2133:
---------------------------------------

Wow I hate conversations in Jira... no threading, etc, etc... oh well off we go... It's a good conversation anyway.

For reference Bruno wrote:

"Regarding using a configuration parameter as prefix, this was my first idea. But then, when I exported a Confluence space and installed locally into hot-deploy I found that while locally I had to link the files with the .html extension, the url to have a page from a live Confluence are without .html and with a "+" instead of spaces. So it seems not to be possible with asimple prefix but we should have a completely different mapping file."

These sound like items to take care of on a check list more than issues....

The "+" instead of spaces is a common way of encoding URLs. You'll find with confluence that a plain space or a %20 works just as well. With the webapp name and view name combination that won't be an issue though.

For the ".html" we can easily have a configured suffix as well as a configured prefix.

> Linking End User Documentation to OFBiz
> ---------------------------------------
>
> Key: OFBIZ-2133
> URL: https://issues.apache.org/jira/browse/OFBIZ-2133
> Project: OFBiz
> Issue Type: New Feature
> Reporter: Bruno Busco
> Assignee: Bruno Busco
> Fix For: Release Branch 9.3
>
> Attachments: help.patch, help.zip
>
>
> I have seen that several updates are in progress in this http://docs.ofbiz.org/display/OFBIZ/End+User+Documentation
> area of Confluence.
> Specially the Accounting application seems going to be described with a one-to-one help page to OFBiz screens.
> This is great and I think that having those pages linked to the relative OFBiz screens will be usefull and will also encourage more people to create (and _fill_) more documentation pages.
> What is attached to this issue is a simple patch that creates this link using the "titleProperty" field.
> It makes no use of the help request that is defined in the framework but uses an even simpler mechanism.
> I would like to discuss this pattern, it is a first trial and I am not sure it will be OK for every case.
> What I was also considering is to have the AccountingHelpUiLabels.xml file not committed but attached to the Confluence documentation main page.
> In this way who updates the documentation can update this "index" file also.
> Who is interested in using the onlline documentation will download this file and install infor OFBiz.
> Who is interested to have a local copy of the help can consider using the export space function present in Confluence.
> This creates a complete static HTML copy of the documentation. A specific version of the AccountingHelpUiLabels.xml can be used to access to this exported copy.
> What do you think?

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Commented: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

[ https://issues.apache.org/jira/browse/OFBIZ-2133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12673066#action_12673066 ]

Bruno Busco commented on OFBIZ-2133:
------------------------------------

David,
you are right.
I tested it and effectively an url with space instead of "+" works both on a local export and on the live Confluence.
I will se two configuration properties for a prefix and a suffix. So that only changing those configuration we could switch between an OOTB Confluence based online help and a local static help.

I think this could be a simple start. I will do that soon pointing to the Open OFbiz wiki.

Thank you.

> Linking End User Documentation to OFBiz
> ---------------------------------------
>
> Key: OFBIZ-2133
> URL: https://issues.apache.org/jira/browse/OFBIZ-2133
> Project: OFBiz
> Issue Type: New Feature
> Reporter: Bruno Busco
> Assignee: Bruno Busco
> Fix For: Release Branch 9.3
>
> Attachments: help.patch, help.zip
>
>
> I have seen that several updates are in progress in this http://docs.ofbiz.org/display/OFBIZ/End+User+Documentation
> area of Confluence.
> Specially the Accounting application seems going to be described with a one-to-one help page to OFBiz screens.
> This is great and I think that having those pages linked to the relative OFBiz screens will be usefull and will also encourage more people to create (and _fill_) more documentation pages.
> What is attached to this issue is a simple patch that creates this link using the "titleProperty" field.
> It makes no use of the help request that is defined in the framework but uses an even simpler mechanism.
> I would like to discuss this pattern, it is a first trial and I am not sure it will be OK for every case.
> What I was also considering is to have the AccountingHelpUiLabels.xml file not committed but attached to the Confluence documentation main page.
> In this way who updates the documentation can update this "index" file also.
> Who is interested in using the onlline documentation will download this file and install infor OFBiz.
> Who is interested to have a local copy of the help can consider using the export space function present in Confluence.
> This creates a complete static HTML copy of the documentation. A specific version of the AccountingHelpUiLabels.xml can be used to access to this exported copy.
> What do you think?

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Commented: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

[ https://issues.apache.org/jira/browse/OFBIZ-2133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12673171#action_12673171 ]

Bruno Busco commented on OFBIZ-2133:
------------------------------------

Could please tell me how can I retrieve the current webAppName in the header.ftl ?
Thank you.

> Linking End User Documentation to OFBiz
> ---------------------------------------
>
> Key: OFBIZ-2133
> URL: https://issues.apache.org/jira/browse/OFBIZ-2133
> Project: OFBiz
> Issue Type: New Feature
> Reporter: Bruno Busco
> Assignee: Bruno Busco
> Fix For: Release Branch 9.3
>
> Attachments: help.patch, help.zip
>
>
> I have seen that several updates are in progress in this http://docs.ofbiz.org/display/OFBIZ/End+User+Documentation
> area of Confluence.
> Specially the Accounting application seems going to be described with a one-to-one help page to OFBiz screens.
> This is great and I think that having those pages linked to the relative OFBiz screens will be usefull and will also encourage more people to create (and _fill_) more documentation pages.
> What is attached to this issue is a simple patch that creates this link using the "titleProperty" field.
> It makes no use of the help request that is defined in the framework but uses an even simpler mechanism.
> I would like to discuss this pattern, it is a first trial and I am not sure it will be OK for every case.
> What I was also considering is to have the AccountingHelpUiLabels.xml file not committed but attached to the Confluence documentation main page.
> In this way who updates the documentation can update this "index" file also.
> Who is interested in using the onlline documentation will download this file and install infor OFBiz.
> Who is interested to have a local copy of the help can consider using the export space function present in Confluence.
> This creates a complete static HTML copy of the documentation. A specific version of the AccountingHelpUiLabels.xml can be used to access to this exported copy.
> What do you think?

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Nicolas Malin (Jira)

[jira] Commented: (OFBIZ-2133) Linking End User Documentation to OFBiz

In reply to this post by Nicolas Malin (Jira)

[ https://issues.apache.org/jira/browse/OFBIZ-2133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12673176#action_12673176 ]

Bruno Busco commented on OFBIZ-2133:
------------------------------------

I think I could use "WebSiteId" and adding all missing in web.xml files. Am I correct?

> Linking End User Documentation to OFBiz
> ---------------------------------------
>
> Key: OFBIZ-2133
> URL: https://issues.apache.org/jira/browse/OFBIZ-2133
> Project: OFBiz
> Issue Type: New Feature
> Reporter: Bruno Busco
> Assignee: Bruno Busco
> Fix For: Release Branch 9.3
>
> Attachments: help.patch, help.zip
>
>
> I have seen that several updates are in progress in this http://docs.ofbiz.org/display/OFBIZ/End+User+Documentation
> area of Confluence.
> Specially the Accounting application seems going to be described with a one-to-one help page to OFBiz screens.
> This is great and I think that having those pages linked to the relative OFBiz screens will be usefull and will also encourage more people to create (and _fill_) more documentation pages.
> What is attached to this issue is a simple patch that creates this link using the "titleProperty" field.
> It makes no use of the help request that is defined in the framework but uses an even simpler mechanism.
> I would like to discuss this pattern, it is a first trial and I am not sure it will be OK for every case.
> What I was also considering is to have the AccountingHelpUiLabels.xml file not committed but attached to the Confluence documentation main page.
> In this way who updates the documentation can update this "index" file also.
> Who is interested in using the onlline documentation will download this file and install infor OFBiz.
> Who is interested to have a local copy of the help can consider using the export space function present in Confluence.
> This creates a complete static HTML copy of the documentation. A specific version of the AccountingHelpUiLabels.xml can be used to access to this exported copy.
> What do you think?

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.