On 31/05/2015 8:42 AM, Jacques Le Roux wrote:
Le 31/05/2015 14:41, Jacques Le Roux a écrit :
It is going to be much better for Integrators that need to produce
marketing materials, RFP responses and custom end-user documentation
that could be largely composed of topics from the shared OFBiz
library of topics simply by defining a map that calls up the topics
that you need in the sequence required and applying a format that
matches the output requirements.
I just don't see how the alternatives that are being discussed can
do this and this seems to be a major value that will motivate people
to contribute.
You know and use DITA professionally so you have arguments. I have no
(at all) experience with AsciiDoc so I can't give good arguments.
Could you though explain what you mean by "RFP responses and custom
end-user documentation that could be largely composed of topics from
the shared OFBiz library of topics simply by defining a map that
calls up the topics that you need"? Notably what is exactly the
"shared OFBiz library of topics"?
Ho, I think you already answered with
http://intuillion.com/2015/05/27/how-we-used-dita-to-automate-generation-of-requirements-documents/
I will read that...
Though still, what is exactly the "shared OFBiz library of topics"?:)
Jacques
Short answer.
The manual or help system git project would have topics such as
*Concept Topics*
- goal of OFBiz eCommerce - OFBiz_eCommerce_goal.dita
- OFBiz eCommerce overview - OFBiz_eCommerce_overview.dita
- OFBiz eComerce Benefits - OFBiz_eCommerce_benefits.dita
- OFBiz eCommerce Features - OFBiz_eCommerce_features.dita
- OFBiz ecommerce and Paypal - OFBiz_eCommerce_with_Paypal.dita
- OFBiz eCommerce and Google Wallet -
OFBiz_eCommerce_with_Google_Wallet.dita
- Shopping cart Overview
*Task Topics*
- configuring PayPay in OfBiz - Configuring_OFBiz_eCommerce_with_Paypal.dita
- configuring Google Wallet in OFBiz -
Configuring_OFBiz_eCommerce_with_Google_Wallet.dita
- Shopping Cart payment process - Paying_with_eCommerce
- with Paypal - Paying_with_eCommerce_through_PayPal
- with Google Wallet - Paying with eCommerce_through_Google_Wallet
There would be hundreds of topics when you start to breakdown all of the
things that one might want to say about OFBiz in help and the web site.
If you were writing a marketing brochure for your company, you would
create a ditamap that included "OFBiz_eCommerce_overview.dita" and
perhaps "OFBiz_eCommerce_benefits.dita" or
"OFBiz_eCommerce_features.dita". The map would include references to
other similar pieces from the library.
You would have your company profile, perhaps some topics targeted at the
industry that you are approaching, and a topic that has your references.
This DITAmap would be processed through your customized DITA-OT process
to add your branding and format it as a brochure.
If you were responding to an RFP that asked about Paypal, you might
select "OFBiz_eCommerce_overview.dita" and
"OFBiz_eCommerce_with_Paypal.dita" with
"Paying_with_eCommerce_through_PayPal" if the RFP asked for details.
You would have your own topics about legal, support, references,
industry experience, etc that you would include in the RFP respose.
--
Ron Wheeler
President
Artifact Software Inc
email: rwhee...@artifact-software.com
skype: ronaldmwheeler
phone: 866-970-2435, ext 102
