dhis2-devs team mailing list archive

[Morten Olav Hansen <morten@xxxxxxxxx>]

Ok, good :)

-- 
Morten Olav Hansen
Senior Engineer, DHIS 2
University of Oslo
http://www.dhis2.org

On Mon, Jun 27, 2016 at 4:13 PM, Aamer Mohammed <aamerm@xxxxxxxxxxxxxxxx>
wrote:

> Yes Morten that was specific to my machine. The issue is identified and we
> are able to build the package successfully.
>
> On Mon, Jun 27, 2016 at 12:44 PM, Morten Olav Hansen <morten@xxxxxxxxx>
> wrote:
>
>> Hi
>>
>> I'm not aware of any extra steps needed, I just built it fine here
>> locally.. (mvn clean package), could be something local on your laptop? I
>> see no complaints from our build server either
>>
>> --
>> Morten Olav Hansen
>> Senior Engineer, DHIS 2
>> University of Oslo
>> http://www.dhis2.org
>>
>> On Mon, Jun 27, 2016 at 1:59 PM, Aamer Mohammed <aamerm@xxxxxxxxxxxxxxxx>
>> wrote:
>>
>>> Hi
>>>
>>> We have forked dhis2-docs repo to get started with the documentation for
>>> the new features. However when we try to build the just cloned repo with
>>> apache maven as mentioned in
>>> http://dhis2.github.io/dhis2-docs/2.22/en/implementer/html/apas09.html
>>>
>>> we are getting below error
>>> ----------
>>> [ERROR] Failed to execute goal
>>> com.agilejava.docbkx:docbkx-maven-plugin:2.0.17:generate-html
>>> (chunked-html-docs-implementer) on project dhis-documentation-docbook:
>>> Failed to transform dhis2_implementation_guide_en.xml.
>>> org.xml.sax.SAXParseException; systemId:
>>> file:///Users/aamerm/Documents/oca/dhis2docs/dhis2-docs/src/docbkx/en/dhis2_implementation_guide_en.xml;
>>> lineNumber: 35; columnNumber: 68; An 'include' failed, and no 'fallback'
>>> element was found. -> [Help 1]
>>> ---------------
>>>
>>> Are there any other steps apart from the ones mentioned in readme.
>>> Please suggest.
>>>
>>> Thanks
>>> Aamer.
>>>
>>> <http://dhis2.github.io/dhis2-docs/2.22/en/implementer/html/apas09.html>
>>>
>>> On Tue, Jun 7, 2016 at 10:48 AM, Vanya Seth <vanyas@xxxxxxxxxxxxxxxx>
>>> wrote:
>>>
>>>> Thanks for the information Lars.
>>>>
>>>> Regards
>>>> Vanya
>>>>
>>>> On Tue, Jun 7, 2016 at 7:26 AM, Lars Helge Øverland <lars@xxxxxxxxx>
>>>> wrote:
>>>>
>>>>> Hi Vanya,
>>>>>
>>>>> thanks for taking the time to document this.
>>>>>
>>>>> Just some suggestions for your question on where to put what:
>>>>>
>>>>>
>>>>>> As we understand that there are 3 manuals
>>>>>>
>>>>>> - Developer guide
>>>>>> - User guide
>>>>>> - Implementor guide
>>>>>>
>>>>>> When we do the documentation are we targeting all these guides?
>>>>>>
>>>>>> Some key aspects that we believe are documentation worthy are:
>>>>>>
>>>>>> - The new API 's (versioning and sync).
>>>>>>
>>>>>
>>>>> Developer guide (API docs)
>>>>>
>>>>>
>>>>>> - The new task (Metadata sync task)
>>>>>> - Metadata Versioning and Metadata Sync as a concept.
>>>>>> - Best practices around the Metadata versioning setup.
>>>>>>
>>>>> - Optimization of the initial setup of new field instances given the
>>>>>> central-field deployment strategy
>>>>>>
>>>>>
>>>>> I suggest a new chapter in the user manual called "Metadata
>>>>> synchronization" for these.
>>>>>
>>>>>
>>>>> http://dhis2.github.io/dhis2-docs/master/en/user/html/dhis2_user_manual_en.html
>>>>>
>>>>>
>>>>>> - The changes to the existing "Settings" app [which is pretty much
>>>>>> part of setting up the Synchronization settings and the ability to create
>>>>>> new versions by enabling versioning ]
>>>>>>
>>>>>
>>>>> Add to settings chapter in user guide:
>>>>>
>>>>> http://dhis2.github.io/dhis2-docs/master/en/user/html/ch23.html
>>>>>
>>>>>
>>>>>> - The changes to the "Data Administration" app where we can now also
>>>>>> schedule the metadata sync at the time of choice.
>>>>>>
>>>>>> Add to data administration chapter in user guide:
>>>>>
>>>>> http://dhis2.github.io/dhis2-docs/master/en/user/html/ch22.html
>>>>>
>>>>>
>>>>>
>>>>>
>>>>>> It would be good if you could help us get started.
>>>>>>
>>>>>>
>>>>> regards,
>>>>>
>>>>> Lars
>>>>>
>>>>>
>>>>>> --
>>>>>> With Regards
>>>>>> Vanya
>>>>>> ThoughtWorks Technologies
>>>>>> Hyderabad
>>>>>>
>>>>>> --Stay Hungry Stay Foolish!!
>>>>>>
>>>>>
>>>>>
>>>>>
>>>>> --
>>>>> Lars Helge Øverland
>>>>> Lead developer, DHIS 2
>>>>> University of Oslo
>>>>> Skype: larshelgeoverland
>>>>> lars@xxxxxxxxx
>>>>> http://www.dhis2.org <https://www.dhis2.org/>
>>>>>
>>>>>
>>>>
>>>>
>>>> --
>>>> With Regards
>>>> ThoughtWorks Technologies
>>>> Hyderabad
>>>>
>>>> --Stay Hungry Stay Foolish!!
>>>>
>>>
>>>
>>
>